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igital makers are the most creative, 
industrious and innovative group of 
people in the world. 

What other group builds chess robots, 
weather-responsive lights, or looks at the 
magical newspaper in Harry Potter and thinks: 
‘I could make that!’ 

Life is about what you build, craft, and create. 

Minecraft is a lovely creation, but the version 
for Raspberry Pi is special. Only Minecraft P 
allows makers to hack and code it. 


Minecraft Pi is digital making on a virtual SUBSCRIBE & 


z 
level. We recommend it to everybody, and this BRILLIANT 
month we have a massive feature on making SEE PAGE 32 FOR DETAILS EN 
with Minecraft. 

This issue is special for me. I’m taking over as 
editor for The MagPi. It's a huge responsibility, 


and I’m tremendously grateful. THIS MONTH: 
The MagPi is a rare publication. A community 


magazine that is loved by a small band of 16 MINECRAFT MAKER GUIDE 


makers, but big enough to shake the tech world. | 
Despite its huge success, The MagPi remains Hack and code Minecraft Pi to create your own world 


a community mag. It's your publication. So tell 40 BUILD A WEB SERVER 


me what you love, and like, and want to see. À 
. i Use a Raspberry Pi to run your own web services from home 
Remember to make things. And don’t forget 


to share with the community. 50 DEVELOP A GAME 


Create a ball-popping puzzle game in Python 
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FEATURE 


ssue 57 of The MagPi 
proved so popular that 
people quickly resorted 
to asking staff to look under 
counters and in back rooms for 
Spare copies to buy. The reason is 
our giveaway: a free AIY Projects 
Voice Kit developed by Google. 
The AIY Projects Voice Kit 
was a free gift with issue 57, 
allowing you to add natural voice 
interactions to your projects easily 
and for free. The kit comprises an 
ATY Projects Voice HAT, a stereo 
microphone, large arcade-style 


“T had fun building the 
#ATYProjects this weekend with 
my son,” tweeted The MagPi 
reader Stephen Keep. "It was his 
first electronics project.” 

“What a wonderful unexpected 
surprise,” said Simon Patterson. 

The magazine quickly sold out 
at WHSmith, Tesco, Sainsbury’s, 
and Asda. We hope you were one 
of the lucky ones who got a copy. 

The magazine was also available 
in the United States at Barnes 
& Noble, Micro Center, and 
other stockists. 


Sign up for The MagP!1 
newsletter for alerts 


button, and a selection of wires. In 
typical Google style, you make the 
case out of cardboard. 

Everybody who got a copy of the 
magazine seemed to love building 
the natural language recognizer. 


“I picked up my copy of The MagPi 
last night,” said Brian Krohn on 
Twitter. “Barnes & Noble only had 
two copies left.” 

With copies quickly selling out, 
many readers wanted to know if 

the kit will be available on 
its own. “Where can I 
order one?” asked 
Will Bunker. 


Left The AIY Projects 
Voice Kit given away 
free with The MagPi 


Above If you want to buy anAlY Projects 
Voice Kit, make sure you sign up 
for The MagPi newsletter 


If you missed the initial release of 
issue 57 and just want the exclusive 
ATY Projects Voice Kit on its own, 
you might be in luck. Raspberry Pi 
and Google are . working to figure 
out away to make the kits available 
in the longer term. 

If you re interested in buying the 
AIY Projects Voice Kit, sign up for 
The MagPi newsletter at magpi.cc. 
We will email you if ATY Projects 
Voice Kit becomes available for 
purchase. Our newsletter is a good 
way to be the first to know about 
special issues of The MagPi. 

We can’t say for sure that the 
ATY Projects Voice Kit will be 
available for purchase, but we are 
pretty confident that a longer term 
solution can be found. 

Many people subscribe to The 
MagPi (magpi.cc/Subs1) and these 
folks got the ATY Projects kit with 
their monthly issue. 

Remember that subscribing to 
The MagPi is the best way to ensure 
you get special projects, like this. 

Don’t forget: you also get a free 
Pi Zero W, case, and cable bundle 
with new 12-month subscriptions. 
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PI ZERO W 
SHIPPED Baus 


Plus 13 new distributors now selling the Pi Zero W PI ZERO W UNITS 
SHIPPED WORLDWIDE 


aspberry Pi has shipped Malaysia, Norway, South Africa 
over 250,000 Raspberry Pi and Sweden. 
Zero W boards, only three Fans in Malaysia, Japan, and 


months after release. South Africa will have to wait for 

The tiny computer only costs the Zero W to achieve certification MONTH S 
£10, yet has wireless networking, first, however. 
Bluetooth, a 1GHz processor, Mike Buffham, Director of 


and 512MB of RAM — no wonder Product Management, says: “We S | | \ | C E 
demand has been so high. are further strengthening our 
We are further strengthening LAUNCH 


our network in the USA, 


Canada, and Germany 1 3 N E W 
Raspberry Pi has also signed network in the USA, Canada, and 


up 13 new distributors around Germany, where demand continues 
the world for the Pi Zero W. to be very high. We are hoping that D I S | | 1 IB | | | O | ) S 
The new distributors serve adding these new distributors will TO e E T ZE R © W 


Australia and New Zealand, make it much easier for Pi fans 
Italy, Finland, Poland, Greece, across the world to get hold of their 
Japan, Switzerland, Denmark, favourite tiny computer.” | O P I FA N S 


me 4,000 


UNITS SOLD 
ON DAY ONE 
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Aquarter of a million shipped already, 
and no sign of that slowing down 


The Spectrum reborn with 
Raspberry Pi as an add-on board 


Below The Pi 
Zero connects via 
the white GPIO- 
sized connector 
to add extra 
processing power 


he Kickstarter 

campaign for an 

updated version of the 
Sinclair ZX Spectrum has just 
closed successfully. 

Called the ZX Spectrum 
Next, the new retro console is 
backwards compatible with all 
Spectrum software, yet features 
hardware updates such as HDMI 
output, a faster processor, anda 
quick menu system to load games 
in seconds. 


Add a Raspberry Pi Zero as 


NEXT-GEN ZX SPECTRUM 


While 
the main unit 
is powered by an 
SLX16 processor on 
a custom-made circuit 
board, you can add a Raspberry 
Pi Zero as a ‘slave co-accelerator 
board’. This novel use of a 
Raspberry Pi means that the 


a ‘slave co-accelerator board’ 


However, if you miss the 
whines and screeches of loading 
software on a Spectrum from 
tape, the Spectrum Next is 
compatible with all original ZX 
Spectrum hardware. 
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Pi Zero becomes the cheapest 
graphics card ever made. 

Even without the Pi Zero, the 
Spectrum Next features a ‘boost 
mode’. Henrique Olifiers, co- 
founder of Bossa Studios and 
one of the creators of Spectrum 
Next, says that games like Hard 
Drivin’ and Starstrike II had 
such low frame rates on the 
original Spectrum that they were 
unplayable. Hit the boost mode 
button and “all of a sudden, this 
is playable now.” 

It’s not just more speed that 
the Spectrum Next offers, but 
improved visuals too. Some 
classic games have a new 
‘enhanced colour mode’ that 


Above The new case adds modern flair, 
but the bare circuit board will fit inside an 
old ZX Spectrum case if you prefer 


“makes the games look much 
better than they did before.” 
Henrique says it adds: “Colours 
that we didn’t have originally, 
with oranges and so on, but it’s 
still the same game!” 

Games can be stored on an SD 
card, and the 512kB of RAM can be 
expanded to 2.5MB. There’s also 
a PS/2 port to add a mouse, anda 
VGA output as well as the HDMI 
to connect to any monitor. 

The ZX Spectrum Next has 
received over £440,000 of 
crowdsourced funding from more 
than 1,900 backers on Kickstarter, 
smashing its target of £250,000. 
We expect the final product to 
start shipping in July 2018. 

More information can be found 
at magpi.cc/2rc3-FjT. 
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Build a personal file server, wireless mobile storage device, 

a Pi Music Box with local storage and so much more. 
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WDLABS Start building your mini file server now at wdlabs.io/mp58a 


Western Digital and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. HDMI and the HDMI logo are trademarks or registered trademarks 
of HDMI Licensing LLC in the United States and other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte 
= one billion bytes. Total accessible capacity varies depending on operating environment. Product and price specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western 
Digital Corporation or its affiliates. 


SHOWS OFF ITS 


OctaPi links eight separate Pis to 
form a single processing ‘cluster’ to 
complete tasks more quickly than a 
single, faster processing unit 


Spy agency takes its Raspberry Pi cluster computer on tour 


K security agency GCHQ brought a few of its up to certain frequencies. This limits the maximum 
toys to the Edinburgh International Science possible level of performance. 
Festival in April, among them an eight-way Instead, ‘scaling out’ adds more processing 
Pi cluster dubbed the OctaPi. units, allowing tasks to be divided and processed 
GCHQ’s aim with the OctaPi is to show how in parallel. This, GCHQ tells us, requires a change 
processing performance and capability can be ‘scaled in approach in how applications and programs 
out’ instead of the typical approach of ‘scaling up’. are coded. 
The latter is proving increasingly hard to achieve, The Science Festival lasts for two weeks every year 
as single processing units can only operate reliably — see sciencefestival.co.uk for details. 


he next challenge for 
Pioneers is to ‘Make it 
outdoors’. This could mean 


anything from using a Raspberry 


Pi to track your pet or making a 

speedometer for your bike. 
Pioneers are UK-based teams 

of between two and five people, 


Next Pioneers challenge is to ‘Make it outdoors’ dase vous, < solar 
group, a group of 
friends with a mentor, or a team 
attending a Pioneers event. If 
you’re over 18, you could mentor a 
Pioneers team: see rpf.io/pioneers 
for details. 

To help you Make it outdoors, 
Pimoroni is offering a 15 percent 
discount on its ‘Getting started with 
wearables’ (magpi.cc/2pY406W) 
and ‘Getting started with Pi 
Camera’ kits (magpi.cc/2pXNpzZ). 
The Shell Centenary Scholarship 
Fund (magpi.cc/2pXGsPf) is 
offering bursaries to cover the costs 
of these kits. 

For more information on 
Pioneers, see ‘This time it’s 
outdoors,’ Page 86. 
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LINKWAVE 
LAUNCHES 


Add anywhere-internet to your Pi 


inkwave has launched 

a 3G HAT for the 

Raspberry Pi, compatible 
with the Pi 2, 3, and Zero. The 
new HAT, called the PiloT, aims 
to make building a Pi-based 
Internet of Things (IoT) device 
easier and quicker. 


UMTS, HSDPA, HSUPA, and 
HSPA+ mobile data standards for 
quick uploads and downloads on 
mobile data networks. 
The PiloT is powered by the Pi, 
using a small USB to micro-USB 
cable (supplied). The PiloT aims 
to be easy to use and implement, 


The PiloT 1s powered by 
the Pi, using a small USB 
to micro USB cable 


There are two versions of PiloT. 


The standard model costs £95 inc. 


VAT while the HL8548-G model 
adds GNSS location information 
(via the SiRF V GPS and GLONASS 
standards) and costs £107 inc. 
VAT. Both versions support 
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with a CDC-ECM mode 

allowing the PiloT to act “as an 

Ethernet-like device. In this mode 

PPP is not required; a simple 

command initiates the session.” 
See magpi.cc/2pXPrjv for 

more details. 


The stories we shared that 
flew around the world 


eż, 


magpi.cc/2p2Ktni 


Supplied with its own brick-by-brick instruction 
manual, this kit allows you to build a retro 
Nintendo NES case out of LEGO. It's perfect 

for housing a Pi 3 running the RetroPie classic 
games emulator. 


magpi.cc/2npYSowW 


Veterans and newcomers alike competed in Pi Wars 
at the start of April. Exa Coding Club's ExaBot finally 
won the overall Schools competition, while Brian 
Corteil's ‘2 wheels or not 2 wheels’ was the Pros / 
Veterans champion. 


magpi.cc/2p4QmNlL 


With some precision 
engineering, a Raspberry Pi 3 
and some Python coding, 
Mike Hamende (known 
online as ‘8PumpkinDonuts’) 
built this telescope mount 

to automatically track 
celestial bodies. 


(2T Al CAMERA TAKES AWARD-WINNING SHOTS 


AWARD-WINNING SHOTS 


Below It took Dries 


and Max ten days 
to make the Al- 
powered Trophy 


Camera, on display 


12 


at the Tetem in 
The Netherlands 
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wo Belgian creatives 
have designed and made 

a camera that 'can only 
make award-winning pictures”, 
thanks to an AI algorithm running 
on a Raspberry Pi. 

The ‘Trophy Camera’ has been 
‘trained’ to identify what makes an 
award-winning image by analysing 
all the previous winning entries 
for the World Press Photos of the 
Year. When you take a picture with 
the Trophy Camera, the camera is 
programmed to ‘recognise, make, 
and save only winning photos.’ 

Intriguingly, the Trophy Camera 
doesn’t even have a viewscreen, 
merely a two-line readout that tells 
you whether the image you have 
taken is of award-winning standard 
or not. The project uses a Pi Zero W 
and the Camera Module v2. 

Asked how the Trophy Camera 
works, Dries Depoorter, the 
engineer of the project, tells us, 
“Point the camera at your subject 
and press the red button... the LCD 
screen will then show what it sees 
in the form of labels, for example: 
inside, room, kitchen, blender. 
Then it will give the photograph a 


rating based on how much it 
looks like a World Press 
Photo winner. If the 
photograph has 90% 

of more correlation 

with the algorithm it has 
created based on the history 
of World Press Photo winners, it 
automatically uploads the picture 
to the website.” 

“The idea for the camera came 
from a concern for the development 
of repetitive visual and aesthetic 
strategies in photojournalism,” 
says Max Pinckers, the other 
half of the Trophy Camera team, 
who is currently researching 
tropes in photojournalism for 
his PhD at the School of Arts 
in Ghent. “Press photography 
appears to be becoming a self- 


The Trophy Camera is described 
as ‘vo.9’, and Max has great plans 
for a future update: “I wanted to 
build the camera so it’s real-time 
and checks real-time [for] award- 
winning pictures. For the moment, 


The technology functions on 
a deeper level that we humans 
cannot see or understand 


referential medium dominated 
by tropes, archetypes, and pop- 
culture references.” 

The Trophy Camera, therefore, 
seems to be a tongue-in-cheek 
demonstration of the lack of 
creativity in what should be an 
intensely creative medium. 

But can an Al algorithm discern 
arresting images from poor- 
quality ones? Dries tells us, “The 
technology in the camera searches 
for patterns in photographs and 
creates its own standards for 
evaluating them, but also functions 
on a deeper level that we humans 
cannot see or understand.” 


you have to press a red trigger. 
The next version is going to be 
real-time.” 

He originally constructed the 
Trophy Camera with a Pi 2, “but 
then the new Raspberry Pi Zero 
W got released, and I ordered 
right away.” Fitting everything 
inside the case was tricky, “so the 
battery is really small... the biggest 
challenge was the software then 
the physical camera. I made it in 
ten days.” 

The Trophy Camera is on display 
in Tetem in The Netherlands until 
30 July. More info (in Dutch) can 
found at magpi.cc/2pXKósw. 
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NEW ROBOT KIT FROM LEGENDARY PI WARS DESIGNER ("277 


NEW ROBOT KIT 
FROM LEGENDARY 
PI WARS DESIGNER 


Make a Tiny 4WD robot rover 


erennial Pi Wars champion Brian Corteil has 
Q partnered with Pimoroni to launch the £55 
Tiny 4WD kit. 

The Tiny 4WD is close, but not idential, to Brian’ s 
remote-controlled robot detailed in issue 51 of The 
MagPi. “The reason for the change to the Pimoroni 
pHAT,” Brian tells us, “was to get the price of the kit 
below £60. If a ZeroBorg was used, the kit would have 
been closer to £90 to £100.” 

The Explorer pHAT also “has buffered 5V inputs/ 
outputs plus four analogue inputs, allowing a range of 
sensors to be added.” 

When selecting motors, Brian advises “the 50:1 
ratio [motors] are a great choice for general use. A 
higher ratio, say 20:1, makes the robot into a more 
sporty model, [but] turning on the spot and climbing 
is not as good due to lower torque. For computer 
vision and sensors, the 298:1 motors are more 
suitable, due to the lower speed.” 

Emma Norling was lucky enough to win a Tiny 
4WD kit recently and shared her experience with it at 
magpi.cc/2pXHCu8. The kit is “really simple to put 
together, and nice and robust. I’ve had experience 
before with kits that are tricky to put together, but 
ultimately robust; or simple to put together but [of] 
poor build quality - this one wins on both counts.” 

You can buy the CoreTec Tiny 4WD Robot Rover kit 
from Pimoroni at magpi.cc/2r8e70S for £55. 
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Above You only need to add a Pi, SD card, and a power source 
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Left The rugged 
Tiny 4WD is 
quick and easy 
to assemble 


INTERNET 


THINGS 
CONTEST 


—— WIN PRIZES FROM ——— 
AMAZON ALEXA DEVELOPERS & 


DEXTER INDUSTRIES 


ENTER ONLINE BY 06.26.17 AT 


ITBL.ES /2017loT 


(ży instructables Ja DEXTER 


INDUSTRIES 
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POWERED BY 


EDUCATION RASPBERRY PI 
eS ea N£ 
|| 
Complete STEAM 
p | z to p Education solution 


Transform your classroom. pi-top provides access to world-class 


THE FUTURE OF STEAM 


www.pi-top.com 
educational resources for the Computer Science (CS) and STEAM ai 
(Science, Technolgy, Engineering, Art and Math) curriculum, designed to 
improve digital literacy with an all-inclusive simple to deliver solution. oett] 
AWARDS 2017 


pi-top ©© pi-topCEED ee 


l OCR 
The modular The modular all-in-one peA 
build-it-yourself Raspberry Raspberry Pi powered h only makar 
Pi powered laptop desktop Ey Och -aleading 


Colors: green or gray 


Colors: green or gray 
Includes Raspberry Pi 


Includes Raspberry Pi 


0 D 
© [U y U 
10 Hour JRC Modular Adjustable 14” Modular 
Battery Life HD Screen Components Viewing Angles HD Screen Components 


modular 
add-on boards 


Available from our distributors: 


sr® np Findel: 2. misco RS UPO 


More power to you 


Lear. Play. Create Quick Launch Notes 


The OCR* endorsed pi-topOS pi-topCODER 
(Operating system) platform comes 
pre-installed on the SD card 
shipped with every unit. pi-topOS 
software suite lets you - browse the 
web, - check emails, - create and 
edit Microsoft Office compatible 
files. It includes pi-topCODER and 
comes with the revolutionary 
educational game CEEDuniverse. 


a — aimee pi-topCODER 


pi-topCODER is the interface that 

allows you to access worksheets 

and pre-built lesson plans. It's the 

easiest way to deliver computer 

science lessons providing 

|-© a step-by-step guides for computer 
science and STEAM worksheets. 
Programming languages that can be 
taught: Python and Sonic Pi (a 
variant of Ruby) 100+ hours of 

= TaToaas| kiall oo lesson plan content. 


a 
|= to Worldwide shipping available in green or grey at www.pi-top.com 
Stay up to date with our latest news by following our social media 


MINELAAFT 
GUIDE 


Want to do more with Minecraft Pi? 
We ve got some excellent projects for you to try, whether you’re a novice or a pro! 


Bare y O We love how easy it is to 
Essentials hack Minecraft on the 
Raspberry Pi. With built-in 
> Raspberry Pi Python libraries that let you modify 
(any model!) the world you’re playing in, the 
> Latest version possibilities are nearly endless! 
of Raspbian In issue 41 we covered some 
> Monitor Minecraft mash-ups, and this 
SKEA issue we’re bringing Minecraft 
and mouse hacking back with five new projects 
that make use of some different 
aspects of the game. Whether it’s 
using a different programming 
method, such as EduBlocks, or 
using RFID cards or a camera 
to connect Minecraft to the 
real world, we’ve got it covered. 
Fire up your Raspberry Pi, and 
get ready to bend Minecraft to 
your will. 


) 
) 
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BASICS 


Your first steps into hacking Minecraft Pi 


All blocks in Minecraft have 
a position labelled X, Y, Z 


rogramming Minecraft in import mcpi.minecraft as 
Python makes use of the minecraft 

special API that allows 

you to control, alter, and interact 105. | Create a connection from your 


m- ------- < 


with the Minecraft world. It even program to Minecraft and call it mc: 
works as you play the game and it 
lets you do the following: mc = minecraft.Minecraft. 


create() 
Get the player's position 

Change (or set) the player's position 06. Use your Minecraft connection 
Idenitfy the type of block and the function postToChat() to 
Change a block put a message in the chat window: 
Change the camera angle 

Post messages to the player mc.postToChat( "Hello 


Minecraft World") which is the spawn point, and the 
player’s current position is shown 
Hello world! Run your program by clicking at the top left of the screen. 
The most basic thing you can do is Run > Run Module or pressing F5. Add the following code to your 
print a message to the player (you!) Back on Minecraft, you ll seethe Hello Minecraft World program to 
in the Minecraft world. Here' show message ‘Hello Minecraft World on teleport the player (called Steve) 
you can do that... your screen. You'll have to be quick, to position x = 0, y = 50, Z = O, 
though, as it only lasts for ten which will put him 50 blocks up in 
01. Go to the Minecraft menu by seconds. Try printing other words the air: 
pressing the ESC key, but leave the and phrases to Minecraft. 


game playing. mc.player.setPos(0, 50, 0) 
Display messages in Minecraft 
using a simple piece of code 


MA Open mir by clicking Menu > E -mmr 
Programming > Python 3. 


You can use similar bits of 
code to change blocks at certain 
positions on the map as well. To 
delete a block, you can make it turn 
into an air block - that’s about as 
3 empty as it gets in Minecraft! 


03. Use File > New Window 
to create a new program 
and then save it as 
hellominecraftworld.py. 


dello Minecraft Hor: 


a Ee 
Ad 
= <> -£ = 
A FR 


Blocks and positions MINECRAFT 
04, At the top of your Minecraft is a world of blocks, all ESSENTIALS | MägPi| EH 


program, type the about 1 m x 1 m x 1 m. The player 


following code to import and every block in the world has a Loved this feature and want HACKING it z 
the ‘minecraft’ module, position made up of x, y, and z; to do more modding with MAKING 
which will allow you to xand z are the horizontal positions, Minecraft? Check out our 

use the API and talk to and y is the vertical. The player Essentials book, Hacking and 


the game: starts at position x = 0, y = 0, Z = 0, Making with Minecraft: 
magpi.cc/Minecraft-book 
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A programming language built into 
Raspbian, Sonic Pi lets you create 
music. It can hook into Minecraft Pi, 


making it perfect for modding. 
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MINECRAFT WITH: 


THE BIG aj 


Unleash your inner Tom Hanks on this giant piano 


n this project, you're going 
to create a piano keyboard 
in Minecraft that can be 
played when Steve (the player) 
walks over the keys. 

This project uses Sonic Pi to play 
the music, Minecraft to visualise 
the piano and act as your input, 
and Python to build the piano and 
allow Sonic Pi and Minecraft to 
communicate with each other. 


STEP 1 

Receiving messages in 

Sonic Pi 

The first step in this project is to try 
to send notes from Python to Sonic 
Pi. This is possible because Sonic 

Pi uses Open Sound Control (OSC). 
This is a way for sound synthesizers 
to communicate with each other 
over a network. 

The first thing to do is to tell 
Sonic Pi to listen out for messages. 
Load up Sonic Pi by clicking on 
Menu > Programming > Sonic Pi, 
and then click into Buffer o to start 
writing code. 

You just need a few lines of code 
in your Sonic Pi file — found in the 


za MARC SCOTT 


Marc is Head of Curriculum 
Development at the Raspberry Pi 
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MC_piano_sound listing (page 21). 
This tells Sonic Pi to listen out for 
notes, and to play them straight 
away. You can run the script, but 
nothing will happen just yet! 


STEP 2 

Sending messages to 

Sonic Pi 

Open up a new Python 3 file by 
clicking Menu > Programming > 
Python 3 (IDLE), then clicking on 
File > New File. You'll need the 
python-osc module for this project, 
so install it with: 


sudo pip3 install python-osc 


The first two lines of piano.py 
(page 21) import the necessary 
methods from the module. 


from pythonosc import osc_ 
message builder 

from pythonosc import udp_ 
client 


Next, you need to create 


an object that will send the 
message. Open Sound Control 


raspberrypi.org/magpi 


raspberrypi.org/magpi 


allows for computers to talk to 
each other, but we’re going to use 
it to get Python to talk to Sonic Pi. 
As both programs are on the 
same Raspberry Pi, you can 
use the home address of the 
Raspberry Pi to tell Python where 
to send the message: this is 
127.0.0.1, and it will be on port 
4559. In piano.py, you Il see a 
line like this: 


sender = udp_client. 
SimpleUDPClient('127.0.0.1', 
4559) 


This sends out the signal to the 
right place. When the play_note 
function activates, it then knows 
where to send the note. 


Building piano keys 

It may seem a little daunting 
attempting to build a piano in 
Minecraft, so it's easier to try 

to break down the problem into 
much smaller chunks. Thisis a 
process that computer scientists 
call decomposition. 

A piano keyboard comprises 
repeating groups of seven white 
keys and five black keys — i.e. 
octaves. Building each of these 
elements one at a time will allow 
you to easily build a keyboard. 

Our code will work by checking 
the location of the player on all 
three planes so we can allocate a 
key press to specific coordinates. 
This is done with the line: 


player_x, player_y, player_z 
= mc.player.getTilePos() 


O DO 00 GII BO PDP = O 
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STEP 4 

Planning the keyboard 

It’s always a good idea to quickly 
sketch out what you want to build 
before you start throwing blocks 
into the Minecraft world. Here’s 
a diagram (above) of an octave of 
a keyboard, showing the x and z 
block positions. 


STEP 5) 

Clearing some space 
Depending on where you are in the 
Minecraft world, you might find 
your piano could be created in the 
middle of a mountain. To prevent 
this, you can clear some space with 
a bulldozer function that will fill 

a cube around the player with air. 
Find this in piano.py as: 


X 


6 7 8 9 1011 12 13 14 15 16 17 18 19 20 21 


def bulldozer(x, y, z): 

mc.setBlocks(x - 30, y - 
Big 74 = BOn o Ge BO S s 2n zA 
+ 30, 0) 


ISTEP E 

Building black keys 

The code uses a function called 
black_key to build the black 
piano keys. The function will need 
to know where to build the black 
piano key, so it will need three 
parameters. These parameters 
will be the x, y, and z position in 
the Minecraft world where the key 
needs to be built. 

The next step is to use the 
setBlocks function, to set a few 
black Minecraft blocks. Ifyou look 
at the black key on the far left, you 
can see that it's two blocks wide 
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STEP BY STEP 


and nine blocks long. So if the 
first block is placed at an x and z 
coordinate, then you need the one 
to its right to be placed at x + 1, 
and the ones below it to be placed 
atz+1up to z+ 8. All the blocks 
can be placed at 1 block below the 
player’s position: y — 1. 

Obsidian seems like a sensible 
material to build the blocks from. 
This has a block ID of 49, so the 
setBlocks code will look like: 


mc.setBlocks(x, y - 1, z, x 
+ 1, y - 1, z + 8, 49) 


Building white keys 

Have a look at the first white 

key in the diagram (page 19). It’s 
three blocks wide and 15 blocks 
long. This time, you need to set 
blocks from x up to x + 2, and 
from z up to z + 14. We'll call this 
function white_key to do this 
using the white tile block, which 
has a block ID of 44, 7. The 44 

is the tile block, and the 7 tells 
Minecraft that it should be white. 


mc.setBlocks(x, y - 1, z, x 
+2; y- 1; z + 14, 44, 7) 


STEP BH 
Making an octave 
One octave consists of seven 
white notes and five black notes. 
As in the diagram (page 19), the 
blocks stretch from x to x + 18. 
The for loop needs to place a 
white key every three block-units 
on the x axis, from 0 up to 18. 
Now you can start making your 
octave function, placing a white 
key at every position provided 
by i. Look in piano.py for 
this function: 
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def make_octave(x, y, z): 
for i in range(0, 19, 3): 
white_key(player_x + 
i, player_y, player_z) 


Next is the black keys. You can 
use the same system for placing 
these. Look at the diagram again. 
This time, the black keys need to be 
placed starting at x = 2. Within the 
make_octave function we can add 
another for loop. 


STEP 10 


Playing your piano 

The next step is to have the piano 
play a note when Steve walks 
over a key. This is handled by 

the big while loop. It starts by 
constantly checking for Steve’s 
current position. 

Next, it finds the block 
below Steve’s feet. The 
problem is that the white keys 
are only half a block in height. 


One octave consists of 
seven white notes and 


five black notes 


At the moment there’s just one 
key too many. A key has been placed 
at x = 8, and you need to make sure 
that this key is missed out. A little 
bit of conditional selection will 
help with this. If the value of i is 
8 then the black_key function 
should not be called. Another way 
of putting this is if i isn’t equal to 8, 
the black_key function should be 
called. So we add the conditional 
if i != 8: tothe function. 


Making the octave again 
Let’s tie all that together now. At 
the end of all the functions we’ve 
made, we can now call the functions 
in the code, and use three lines to 
set it all up. First bulldoze the area, 
then make the piano, and then 

on the last line set the player’s 
position, so that Steve moves to the 
middle of the piano. 

Now when you save and run your 
code, a piano octave should appear 
beneath your feet. Each time you 
run the code, a new octave will 
be produced. 


If Steve is standing on a white 
tile, because of their smaller 
height, block_below ends up 
being the air that’s beneath 

the piano. We handle this with 
a conditional, and check if the 
block below is not a white or 
black key, which is what this bit 
of code does: 
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block_below = 
mc.getBlock(new_x, new_y - 1, 
new_z) 
if block_below != 44 and 
block_below != 49: 
block_below = 
mc.getBlock(new_x, new_y, 
new_z) 


Next, we find Steve’s position 
relative to the piano’s position. The 
piano was placed at player_x, but 
Steve is now standing at new_x. 
Subtracting one from the other will 
tell you where Steve is standing on 
the piano octave. 

After this is a list of notes to be 
played. Starting from middle C, the 
white notes have MIDI values of 
60, 62, 64, 65, 67, 68, and 71. The 
black notes are the MIDI values in 
between the white notes. You can 
place a o into the black_notes 
as there are only five of them on 
the keyboard. 

The specific white note to play, if 
Steve is standing on the white note, 
can be found by dividing his relative 
x position by -3 and then ignoring 
the remainder. This is called floor 
division, and can be done in Python 
using the // operator, like so: 


if block_below == 
notes_along = relative_ 

position // -3 
play_note(white_ 

notes[notes_along] ) 


To find the black note to play, 
we subtract 1 from Steve 's relative 
position, floor dividing by 3, and 
then subtracting 1 again. This is 
because the notes are only two 
blocks wide. 

And that's it. Try running the 
code and then moving over the 
blocks. So long as Sonic Pi is open 
and running your initial script, 
you should hear the piano being 
played each time Steve steps on a 
particular key. 


Tr 
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MINECRAFT MAKER GUIDE feature 


MC_piano_sound 


set_sched_ahead_time! 0 
live_loop :listen do 
message = sync 


FILE NAMES: 
MC_piano_sound 
piano.py 


DOWNLOAD: 


3 i.cc/ 
note = message[:args][2] cs 
play note 

end 


piano.py 


from pythonosc import osc_message_builder 
from pythonosc import udp_client 

from mcpi.minecraft import Minecraft 
from time import sleep 


sender = udp_client.SimpleUDPClient( 
mc = Minecraft.create() 


, 4559) 


player_x, player_y, player_z = mc.player.getTilePos() 


def (a Win Ae 
mc.setBlocks(x - 30, y - 3, z - 30, x + 30, y + 20, z + 30, 60) 


def (Oran Win, FAS 
mc.setBlocks(x, y - 1, z, x + 1, y - 1, z + 8, 49) 


def Gy Win 2508 
ma.setBillocks(x, y= 1 z, xwr 2,y = 1, z * 14, 44, 7) 


def GG Wa TZ): 
for i in range(8, 19, 3): 
white _key(player_x + i, player_y, player z) 
for i in range(2, 18, 3): 
ipoial=>e: 
black _key(player_x + i, player _y, player_z) 


def (note): 
sender.send_message( , note) 
sleep(0.5) 


bulldozer(player_x, player_y, player_z) 
make_octave(player_x, player _y, player_z) 
mc.player.setPos(player_x + 8, player_y + 3, player_z + 12) 


while True: 
new_x, new_y, new_z = mc.player.getTilePos() 
block_below = mc.getBlock(new_x, new_y - 1, new z) 
if block _below != 44 and block_below != 49: 
block_below = mc.getBlock(new_x, new_y, new_z) 
relative position = player_x - new_x 
white notes = [60, 62, 64, 65, 67, 69, 71] 
black_notes = [61, 63, ©, 66, 68, 70] 
if block_below == 44: 
notes_along = relative_position // -3 
play_note(white_notes[notes_along]) 
if block_below == 49: 
notes_along = ((relative_position - 1) // -3) - 1 
play_note(black_notes[notes_along]) 


You'll 
need 


> A Raspberry Pi 


Camera Module 
magpi.cc/28ljlsz 


n this tutorial you'll use 

the Pi Camera Module to 

take a selfie of yourself, 
and then with a bit of Python 3 
code, you'll render the picture in a 
gigantic wall of Minecraft blocks. 


STEP 1 

Importing some modules 

For this project you'll need to begin 
by importing a few modules. Most of 
them are pre-installed in Raspbian, 
but you need to install skimage 
yourself by opening the Terminal 
and entering: 


sudo apt-get install 
python3-skimage 


Open Python 3 (IDLE) from the 
Menu. Create a new file by clicking 
on File > New File. Copy the code 
from the minecraft_selfie.py 
listing (page 25). For this, we’re 
importing the picamera module to 
control the camera, and skimage 
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SELFIES 


Smile! You re on camera and in the Minecraft world 


to analyse the image. Save your 
file as minecraft_selfie.py. 


Taking a selfie 
The first stage is fairly simple. 
You're just going to use the Pi 
Camera Module to take a selfie. 
Below the Python module 
imports we've set up the camera 
object, and set its resolution with 
the following two lines: 


camera = PiCamera( ) 
camera.resolution = (80,60) 


You could use a larger resolution, 


but the code takes much longer to 
run, even on a Pi3. 


T 


rar MARC SCOTT 
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Next, the code starts a preview of 
the camera, waits a little bit, then 
captures an image which is saved as 
selfie.jpg. That’s the first part of 
the script finished. 


Mapping colours to blocks 
Download the colour map 
(magpi.cc/2pQJaHS) and place 
it into the same directory as your 
Python script. The image is tiny 


MINECRAFT WITH: 


use it in Minecraft 


Marc is Head of Curriculum 
Development at the Raspberry Pi 
Foundation. He also likes pyrotechnics. 


RASPBERRY PI CHMERA MODULE 


The official camera add-on board for the Raspberry 
Pi. It works well with Python, which means we can 


T 
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This is an extract of the 
representation of the colours in 
the colour map. The first row — 86, 
74, 46 — represents the first pixel 
in the colour map. It’s made up 

of three numbers: the first is the 
amount of red, the second the 
amount of green, and the third 
the amount of blue. Overall, this 
gives a brown colour. We call this 
RGB colour. 

Now that you have the RGB 
values of the pixels in your selfie 
and the colours of the blocks from 
the colour map, if you could find 
the nearest colour from the map 
to the one in the selfie, you would 
know which block to place. 


(only 7 x 7 pixels), but we’ve 
enlarged it to show you what it 
looks like: Fig 1. 

Each pixel on the colour map 
is the same average colour as a 
Minecraft block. The block in the 
top-left is dirt, for instance. 

You need to load both this 
colour map and the selfie into the 
program, so that they become 


Finding the nearest colour 
Now this is where it gets a bit 
complicated. Each colour is made 


Each pixel on the colour 


map is the same average 
colour as a Minecraft block 


represented by lists of numbers. 
This is where the skimage module 
becomes useful: 


up of three numbers, so you could 
plot the position of the colour 

on a graph. The colour R - 137, 

G - 164, B - 123 has been plotted 


selfie_rgb = io.imread("selfie. ona 3D graph (Fig 2). 


jpg") Now all the colours from the 
map_rgb = io.imread("colour_ colour map can also be plotted 
map.png") on the same graph, using smaller 


points so you can still see the 
original colour (Fig 3). 

It stands to reason that the 
closest dot in 3D space to the 
original colour would appear to 
be the closest colour visually. 
Unfortunately, this is not the 
case. While RGB values are useful 
for us when describing colours, 
they’re not very useful for 
comparing colours. Have a look 
at Fig 4 and Fig 5. 


The variables become arrays 
which will be represented as 
something like this: 


array([[[ 86, 74, 46], 
[ 93, 69, 49], 
[ 90, 87, 87], 
[ 99, 84, 65], 
[ 74, 73, 68], 
[108, 105, 95], 
[106, 95, 87]], 


| 
A 
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Fig 2 


MI 
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(o, 0): (2, 0), 


» 3): (35, 
4): (35, 
„ 5): (35, 
, 6): (35, 
, 0): (41, 


(o, 1): (3, 0), 
(o, 2): (4, O), 
(o, 3): (5, O), 
(0, 4): (7, 0), „ 1): (42, 
(0, 5): (14, O), „ 2): (43, 
„ 3): (45, 


, 4): (46, 


(o, 6): (15, O), 
(1, 0): (16, 0), 
„ 5): (47, 

„ 6): (48, 0), 
„ 0): (49, 0), 


(1, 1): (17, 0), 
(1, 2): (21, O), 
(1, 3): (22, O), 
(1, 4): (24, O), „ 1): (54, O), 
, 2): (56, 

„ 3): (57, 0), 
„ 4): (58, 0), 
, 5): (60, 

„ 6): (61, 0), 
, 0): (73, 

, 1): (79, O), 


(1, 5): (35, O), 


(1, 6): (35, 1), 


(2, 0): (35, 2), 
(2, 1): (35, 3), 
(2, 2): (35, 4), 
(2, 3): (35, 5), 
(2, 4): (35, 6), 
(2, 5): (35, 7). 
(2, 6): (35, 8), 
(3, 0): (35, 9), 
(3, 1): (35, 10), 


, 2): (80, 0), 
, 3): (82, 0), 
, 4): (89, 0), 
, 5): (103, 0), 


(3, 2): (35, 11), , 6): (246, 0) 


Although the dark grey and light 
grey squares in Fig 4 appear to be 
similar colours, Fig 5 shows that 
they re actually 173 units apart. The 
light grey and dark grey dots are 
both closer to the red (150 units) 
than they are to each other. For this 
reason, comparing RGB values is 
not very useful, as colours that are 
close to each other in 3D space may 
visually appear to be very different. 


HGH 

Converting to Lab 

colour space 

Because of this disparity in the 3D 
space, we convert the RGB values 
into what’s known as Lab colour 
space. In Lab colour space, distance 
between colours in 3D space is very 
similar to our own perception of 
what could be called similar colours. 


24 MägPi June 2017 


The skimage module makes 
conversion to Lab colour space from 
RGB colour space easy. You just need 
these two additional lines: 


selfie_lab = color. 
rgb2lab(selfie_rgb) 
map_lab = color. 
rgb2lab(map_rgb) 


STEP E 

Mapping the blocks 

The next part in the code involves 
mapping the pixels from the colour 
map to actual Minecraft blocks. A 
dictionary is used to do this. 

Minecraft blocks have two values 
associated with them; for instance, 
dirt is 2, 0. The o is used as there's 
only one type of dirt block in 
Minecraft. Wool has many types 
with different colours, so wool can 
range from 35, O up to 35, 15. 

The hard work has been done for 
you here. If you look at the table 
(Fig 6), you can find the pixel values 
from the colour map mapped to 
their corresponding Minecraft block. 


STEP 7 

Starting the Minecraft API 
Now it’s time to place the blocks. 
First we find the position of 

the player. Then comes the clever 
bit. You’re going to iterate over all 
the colours in the selfie_lab first 
of all. To do this, you'll need the help 
of the enumerate function, which 
will keep track of your position in 
the selfie: 


for i, selfie_column in 
enumerate(selfie_lab): 


Fig 8 


for j, selfie_pixel in 
enumerate(selfie_column) : 
distance = 300 


These three lines will go over 
every pixel in the selfie and 
store each value of the pixel as 
selfie_pixel. The distance will also 
be set to 300, and the coordinates of 
each pixel will be saved as i, j. 

Next, you need to iterate over 
every pixel in the colour map in the 
same way: 


for k, map_column in 

enumerate(map_lab): 
for 1, map_pixel in 

enumerate(map_column) : 


Now the distance between 
the colours of the pixels can 
be calculated: 


delta = color.deltaE_ 
ciede2000(selfie_pixel,map_ 
pixel) 


If the delta is less than the 
distance that was set before, then 
distance is reset to be the delta. 
The block can then be looked up 
from the dictionary of colours you 
set earlier: 


if delta < distance: 
distance = delta 
block = colours[(k,1)] 
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Now out of that part of the loop, 
you can set the appropriate block. 
It’s going to be set relative to the 
player’s position, but quite high up 
in the air: 


mc.setBlock(x-j, y-i+60, z+5, 
block[@], block[1]) 


Now try running the full code and 
see what happens. You might need 
to have a brief hunt around as the 
blocks are being laid, and be patient 
as it doesn’t happen instantly. You’ ll 
get something like Fig 7. 


STEP @ (extra) 
A better (but slower) 


algorithm 

You can get a more accurate 
representation by using a different 
algorithm for calculating the delta 
value. This will be slower, but 
might give you a better result (so be 
very patient). Replace the line... 


delta = color.deltaE_ 
cie76(selfie_pixel,map_pixel) 


...with the line: 
delta = color.deltaE_ 
ciede2000(selfie_pixel,map_ 


pixel) 


See the improvement in Fig 8. 


MINECRRFT 
PHOTOEOOTH 


Want to do more with cameras 

and Minecraft? There's a slightly 
different project you can try called 
the Minecraft photobooth. In it, you 
program Minecraft so that whenever 
Steve enters a photobooth in the 


minecraft_selfie.py 


from picamera import PiCamera 

from mcpi.minecraft import Minecraft 
from time import sleep 

from skimage import io, color 


camera = () 
camera.resolution = (80,60) 
camera. () 

(15) 
camera. ('selfie.jpg') 
camera. (©) 
selfie_rgb = io. ("selfie.jpg") 
map_rgb = io. ("colour_map.png") 
selfie_lab = color. (selfie_rgb) 
map_lab = color. (map_rgb) 


DOWNLOAD: 
magpi.cc/ 
MinecraftMaker 


colours={(@,0):(2,0),(@,1):(3,0),(0,2):(4,0),(0,3):(5,0),(0,4):(7,9), 
(0), 5) :(14,0)/ .(0,6):(15,08) 5 (510) (16 510)) 5 (5 1) 27, 8) 51015 2) (21, 6). G5 3) 
(2250)(1540)5(24.0)5CTF50EG5N00N(A60EG5 DZCZZARSS ZZ DE 
(2552) (252) NES ae) 5 (52) E a (Żyd 8 E550) 4 (24583557) 4 252 
CEED (ese) (S 559) (Seis (Goel Oe G20ES5 MN (GP)AG512)(G:4)E 
(35.13), (Gr S)n(35 514) 5356) s(355 15). (46) (ATO) (4d) (42510) (4 2)s 
(43,0), (4,3):(45,0),(4,4): (46,0), (4,5):(47,0), (4,6): (48,0), (5,0): 
(4950) (S54) (54.0) (55:2) (560) (673): (670) (6 A5870) (515): 
(60,0),(5,6):(61,0),(6,0):(73,0),(6,1):(79,0), (6,2) (800) (6,3): 


(82,0), (6,4): (89,0), (6,5):(103,0), (6,6): (246,0)} 


Minecraft world, it takes a picture mc = Minecraft. () 
with the camera in real life. Check it X, y, Z = mc.player. () 
out here: magpi.cc/2pkDgLF 
for i, selfie_column in (selfie_lab): 


for j, selfie_pixel in 

distance = 300 

for k, map_column in (map_lab): 

for l, map_pixel in (map_column): 

delta = color. (selfie_pixel,map_pixel) 
if delta < distance: 

distance = delta 

block = colours[(k,1)] 

(x-j, y-i+60, z+5, block[@], block[1]) 


(selfie_column): 
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STEP BY STEP 


Build your own Minecraft treasure hunt with an exciting new 
program called EduBlocks — an easy way to transition from 
Scratch to Python 


duBlocks server version 1.0.0 online and ready 
tarting... 


EDUELOCKS 


EduBlocks is a way to bridge the gap between Scratch and 
© Python, using blocks of Python code to make your project. 


The EduBlocks interface 
i is similar to Scratch and 


as easy to use 


All of the output from 
our code can be seen 
in the Minecraft world 


Controlling Minecraft 


Import libraries 

In EduBlocks we can import 
libraries in the same way that 
Python handles libraries. To 
import the ‘minecraft’ library, go 
to the Minecraft menu, click on 
General and drag the from mcpi. 
minecraft import Minecraft 
block into the workspace. Now, 
from the same menu, drag across 
themc = Minecraft.create() 
block and snap it underneath the 
previous block. Next, we drag the 
import math block from the Basic 
menu and snap it underneath the 
previous block. 


from mcpi.minecraft import Minecraft 
mc = Minecraft.create() 


import math 


Creating diamonds 


Set up the blocks 

Using mc.setBlock[x],[y],[z], [i] 
from the Minecraft > Commands 
menu, we shall set the position 

of the first diamond in our hunt. 
The position of the Diamond block 
is set by the x,y,z coordinate; 

the block type, 57, refers to the 
diamond block. 

Next, we create three variables 
called one, two, and three. To do so, 
we go to the Basic menu and scroll 
down until we see the [6] = [@] 
block; this is used to represent a 
variable. Drag this block to the 
workspace three times and change 
the contents of the block so that 
we have three variables — one, two, 
and three - and the distance_ 
to_player section is completed as 
shown in the screenshot. 


Ea distance to player(50,25,11 


) 
distance to player(70,10,25) 


ES distance to player(20,35,43) 


T 
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Here we can see how far away the diamond 


is. This is posted to the Minecraft chat 
window as we move around the world 
? blocks away 
: 7 blocks away 
Blacks away 


r blocks away 


* blocks away 
blacks away 


blocks away 


: 7 blacks away 
: 7 blacks away 


( blacks away 


Create your first loop 
From the Basic menu, we'll use 
awhile loop. Drag this to the 
workspace and snap it under the 
previous blocks. In the blank 
area for the loop, we shall create 
a condition that will run the 
loop while the player’s distance 
is greater than five blocks from 
the diamond at position one, 
controlled by the variable that we 
have just created. 

Now we use another variable 
block which updates the 
player’s position in relation 
to the diamond. We use the 
mc.postToChat(" ") block from 
the Minecraft >> Commands menu 
to inform the player where to look. 
The distance is calculated from 
the variable, in this case one, and 
we round the value returned to 
one decimal place using the round 
function. Otherwise the value 
returned is rather long. We then 
convert the integer into a string in 
order to join it to the message. 


away 


Placing our second diamond 
For the second diamond we also 
usemc.setBlock[x],[y],[z], [i] 
from the Minecraft > Commands 
menu. But this time we update 

the x,y,z coordinates so that the 


diamond appears elsewhere in 
the world. In order to update the 
player’s position in relation to 
the second diamond, we need to 
place another variable block. This 
block will update the two variable, 
and also update the chat window 
to help guide the player to the 
new block. 


Placing our final diamond 
In this final step, we will create a 
third diamond using exactly the 
same blocks and logic as we have 
used to construct the two other 
diamonds. Do you think that 

you can hack the game to have 
the diamonds pop up in other 
positions in the world? 

Remember to save your work 
by clicking on the Save button in 
the top right corner of the screen 
before testing your code. 

To start the game, click on the 
Run button located in the top right 
corner and then ensure that the 
Minecraft window is visible. You 
can now hunt for those elusive 
three diamonds in the Minecraft 
world. Can you find them all? 
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STEP BY STEP 


RFID 
Radio-frequencey identification, or 
RFID, allows computers to recognise 


This project allows you to change the Minecraft Pi character KR MED 
by placing different RFID cards on an RFID detector contactless technology 


The Minecraft skin is 
changed to the one 
shown on the RFID card! 


7* male-to- 
female jumper 
wires 

Small breadboard ? 


RFID-RC522 
module 


Afew 
Mifare cards 


angled pin to the RFID reader to update 


8-way right- The RFID card is brought close ZR 
the Minecraft character 


STEP 4) 


Make your card character 
You can either draw your chosen 
Minecraft characters on a sheet 

of paper, or download character 
images from minecraftskins.net 
and print them. Cut your character 
out and use a glue stick to stick it to 
the Mifare card. Do this for as many 
characters as you want. 


Get the code 

Type the following command to 
install the xdotool app, which lets 
you perform window management 
tasks using shell commands: 


sudo apt-get install xdotool 


This will be used in the code to 
refresh the Minecraft window so 
the skin is automatically updated. 
Download the project from GitHub 
(magpi.cc/2pgdXio) and place it 
in a new project folder. Move the 
skins you saved earlier into the 
skins folder of the project. Run the 
Python file Read.py by typing sudo 
python Read. py, and place each of 
the Mifare cards on the RFID reader. 
This should test the circuit setup 
and give you the cards’ unique IDs. 
Replace the card IDs in the code, 
with the IDs read by running Read. 
py. Replace the skinFile variable 
in charMinecraft.py with the 
corresponding skin file names from 
the skins folder. 


Get ready to play! 

Launch Minecraft and run the 
updated Python code by typing sudo 
python charMinecraft.py in the 
Terminal. Make sure the game is in 
third-person view by pressing the 
ESC button in the game and then 
clicking on the third-person view 
button. Place the Mifare card on the 
RFID reader to change the character. 
Once the card is placed, an on- 
screen message should say which 
character you are changing to. The 
skin is then updated and you can 
continue to play your favourite game 
with your favourite character! 
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charMinecrafi.py 


import RPi.GPIO as GPIO 

import MFRC522 

import signal 

import mcpi.minecraft as minecraft 
import time,os 


tł Capture SIGINT for cleanup when the 


(signal, frame): 
global continue_reading 


print 
continue_reading = False 
GPIO. () 


#Replace SKIN ile names nere 


skinFile=[ f z 
skinNames=[ 3 ; 
idx=1; 
winSizex=1800 #set minecraft window 
winSizeY=800 
#create minecraft connection 
mc = minecraft.Minecraft. () 
continue_reading = True 
#Replace the card IDs here 
UIDs=[ 3 p 3 3 3 3+3 3 
# Hook the SIGINT 
signal. (signal.SIGINT, end_read) 
# Create an object of the class MFRC522 
MIFAREReader = MFRC522. () 
i=0; 
print 
# This loop keeps checking for cards 
while continue_reading: 
# Scan for cards 
(status, TagType) = MIFAREReader. 
# If a card is found 
if status == MIFAREReader.MI_OK: 
print 
# Get the UID of the card 
(status,uid) = MIFAREReader. 
# If we ha the UID, continue 
if status == MIFAREReader.MI_OK: 
# Print UID 
print +str(uid[0])+ 


(uid[2])+","+str(uid[3]) 


uid_str=str(uid[@])+", "+str(uid[1])+ 


EPY: 
idx=UIDs. (uid_str) 


os. ( + skinFile[idx] 


+ (winSizeX)+ + (winSizeY+i%2)) 


except 


( 


) 


O 


( 


FILE NAMES: 


charMinecraft.py 


DOWNLOAD: 
magpi.cc/2pgdXio 


(MIFAREReader.. PICC_REQIDL) 


(uid[1])+ +\ 


uid[2])+","+str(uid[3]); 


) 


+skinNames[idx]+'!') 


STEP BY STEP 


Create a simple Python GUI, using appJar, to control your Minecraft world 


mr” w.” 
Type and send 
Goirand ika messages from here 
Chat Race you to the top... 


Movement 
FORWARD 


LEFT JUMP 
> Controlyour 
BACKWARD character with E] 
these buttons 
Stone 
Diamond 
Torch 
| Race you to the topu 
Select and drop blocks 4 
where you stand = 
Pa 4 ay i 5 LE OE: 
appJar 
appJar.info 
L 
4 
e 


APPIAR 


The appJar library is a way to create graphical 
a interfaces using Python code. It's very easy to use, as 
you can see from our script. az 


a 


MINECRAFT MAKER GUIDE 


code_5.py Leć 


>PYTHON 


001. łł import libraries 052. mc. () 
082. from appJar import gui 053. app. ("Save", FILE NAMES: 
003. from mcpi.minecraft import Minecraft "Checkpoint saved.") code_5.py 
004. 054. elif choice == "Restore": 
005. ił connect to Minecraft 055. if app. ("Restore", DOWNLOAD: 
086. mc = Minecraft. (©) "Are you sure?"): magpi.cc/ 
007. 056. mc. (©) MinecraftMaker 
008. # 1 - CHAT FUNCTION 057. elif choice == "Normal": 
089. sendChat(btn): 058. mc.camera. (©) 
010. msg = app. (Chati) 059. elif choice == "Fixed": 
011. mc. (msg) 060. mc.camera. () 
012. 061. elif choice == "Follow": 
013. # 2 - MOVEMENT FUNCTION 062. mc.camera. () 
014. move(btn): 063. 
015. x, y, Z = mc.player. () 064. # create the GUI - must come first 
016. if (hen) Se SUES E: 065. app = ('appJar Minecraft") 
017. x -= 1 066. app. (100,100) 
018. elif btn == "RIGHT: 067. 
819. X += 1 068. # 1 - CHAT WIDGETS 
020. elif btn == "FORWARD": 069. app. ("Chat", row=0, column=0) 
021. ZASEST 078. app. ("Send", sendChat, row=@, column=1) 
022. elif btn == "BACKWARD": Orle 
023. Z += 1 072. # 2 - MOVEMENT WIDGETS 
024. elif btn == "JUMP": 073. app. ('Movement", row=1, column=60, 
025. y += 1 colspan=2) 
026. z -= 1 074. app. ("NESW") # make buttons stick to 
027. all sides 
028. mc.player. CG Me 2) 075. app. ("FORWARD", move, row=@, column=1) 
029. 076. app. ("LEFT", move, row=1, column=@) 
030. # 3 - STATUS FUNCTION 077. app. ('JUMP", move, row=1, column=1) 
031. updateStatus(): 078. app. ("RIGHT", move, row=1, column=2) 
032. X, y, Z = mc.player. () 879. app. ( "BACKWARD", move, row=2, column=1) 
033. app. CX = + (x), field=0) 080. app. (©) 
034. app. (Neo OWE (y), field=1) 081. 
035. app. CZ: EF (z), field=2) 082. # 3 - STATUS WIDGETS 
036. 083. app. (fields=3) 
037. # 4 - BLOCKS FUNCTION 084. app. (updateStatus) # call 
038. BLOCKS = {"Stone": 1, "TNT": 46, "Torch": 50, 085. updateStatus in a loop 

"Diamond": 57} 086. 
839. drop(btn): 087. # 4 - BLOCKS WIDGETS 
040. X, y, Z = mc.player. (©) 088. app. ("Block", list(BLOCKS), 
041. 4 2 5 jl row=2, column=@) 
042. height = mc. (x,z) 089. app. ("Drop", drop, row=2, column=1) 
043. 090. 
044. playerBlock = app.getOptionBox( 'Block') 091. # 5 - MENU WIDGETS 
045. blockId = BLOCKS[playerBlock] 092. app. ("Checkpoint", ["Create", 
046. "Restore"], clickMenu) 
047. mc. (x, height, z, blockId) 093. app. ("Camera", ["Normal", "Fixed", 
048. "Follow'], clickMenu) 
049. # 5 - MENU FUNCTION 094. 
050. clickMenu(choice): 095. # start the GUI - must come last 


051. if choice == "Create": 096. app.go() 
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» The Turk takes 
20-40 seconds 
to make a move 


> It makes use of 
the Stockfish 
chess engine 


> The chessboard 
is spray-painted 
onto the table 


> Three 100W 
LED floodlights 
illuminate 
the board 


» Adaemon 
process on the 
Pi handles all 
the software 
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The amazing chess-playing robot 
with a Raspberry Pi hidden inside 


he chess player ponders 

the next move. Suddenly, a 

mechanical arm whirs into 
action, moves over the board, lowers 
an electromagnet, and picks up a 
piece... Checkmate! Joey Meyer’s 
Raspberry Turk (raspberryturk.com) 
is an ingenious chess-playing robot 
that was inspired by the eighteenth- 
century ‘Mechanical Turk’. While 
the latter machine had a human 
player concealed inside to determine 
its moves, the Raspberry Turk uses 
a Raspberry Pi 3 as its brain. 

“My co-worker introduced me to 

the eighteenth-century Turk years 


ago and I was always fascinated by 
it,” Joey tells us. “A couple years 
ago I read The Turk: The Life and 
Times of the Famous Eighteenth- 
Century Chess-Playing Machine 
by Tom Standage, and loved it. After 
spending time learning computer 
vision and machine learning last 
year, I began looking for a project 
that would allow me to use what I 
had learnt. I made the connection 
and decided it would be a fun and 
challenging project.” 

Joey says the hardware was the 
hardest part of the project. “Iam 
a software engineer, and building 


The arm lowers a beam with 
an electromagnet to pick up 
pieces by their metallic tops 


Made from Acrobotics, the robotic 
arm can move freely horizontally 
while maintaining a fixed height 


The pieces are brightly coloured 
to aid identification in the camera 
view using OpenCV algorithms 


|= 


| 


The gripper mechanism works by 
activating an electromagnet at the 
end of a vertically moving beam 
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BUILD A CHESS ROBOT 


hardware is a very different 
process.” One difficulty encountered 
was in interfacing Dynamixel servos 
with the Acrobotics components 
that make up the robot arm. “This 
gave me the opportunity to use 3D 
printing to build components to 
solve this problem.” 


>STEP-02 


started this so I could use material 
had learnt in a real project, but 
documenting the build process gave 
me the opportunity to help others 
earn, too.” 

Asked how difficult would it be 
for other makers to replicate, Joey 
replies: “If you re comfortable with 


Another challenge was making 
the arm movements precise 


Another challenge was making 
the arm movements precise. “In 
a perfect system, the movement 
of the arm could be modelled by 
a simple math equation, but due 
to inaccuracies in measurements, 
and unexpected real-world effects, 
this simple math equation model 
broke down. It did well, but not well 
enough to consistently grab the 
piece every time.” Joey solved the 
issue by collecting a dataset of arm 
movements to see where the model 
was having problems. “The results 
worked well and the arm can move 
very accurately now.” 

The Raspberry Turk took Joey 
around five months to build 
and the process has been fully 
documented on his site. “I knew! 
wanted to open-source the robot 
and describe the build process 
on a website from the beginning. 
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some electronics, programming, 
math, and some simple handiwork, 
this project would be a big 
challenge, but is definitely doable. 


= ę VSD 


Sd W R 4 = 
22 w, 19 > | 
Ss 3% * © "o 


RASPBERRY TURK 


Projects 


>STEP-03 


The code I wrote for mine is freely 
available. The website explains 
how everything works in detail and 
I am happy to answer questions 
for anyone who wants to take on 
the challenge. Several people have 
already reached out, telling me 
that they are working on building 
their own!” 

While the Turk hasn’t been 
showcased in public yet, Joey 
says the response of those who 
have seen it has been interesting. 
“Reactions are usually positive, 
but then they quickly change to 


Below The arm's 


; Dynamixel AX- 
shock when they realise the robot 12A servos are 
fone: ; +) : controlled by the 
isn’t just playing them, it’s beating Pi via an ArbotiX.M 
them — badly! Robocontroller 


9 
(44 > 
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Engineer and business owner 


æ PIET RULLENS JR 


by day; Daily Prophet reporter 
Rita Skeeter by night. 
magpi.cc/ 2qvNA8i 


HARRY POTTER 8 
THE DAILY PROPHET 


When muggle newspapers simply weren’t engaging enough, Piet Rullens Jr 
decided to create an animated fan build of the iconic Harry Potter tabloid 


The Wizarding 
World of Harry 
Potter is in 
Orlando, Florida 


Piet took the 
idea from the 
moving tabloid 
in the books 
and movies 


A hidden lead 
keeps the 
frame powered 
and ready 

for action 


Asepia effect 
gives the video 
an added layer 
of authenticity 


Despite popular 
belief, Neville 


was the chosen | 


one, not Harry 


Piet designed the paper in 
Photoshop before printing 
it to his exact specifications 


hen Piet and Linda 

Rullens took a trip to The 

Wizarding World of Harry 
Potter in Orlando, Florida, they 
made sure to bring back a memory 
card s worth of holiday footage. 
But what do you do with holiday 
video footage once you re home? 
Taking his inspiration from the 
fictional world that forged the 
destination for their vacation, Piet 


decided to create his own Daily 
Prophet newspaper, complete with 
moving images. 

For those unfamiliar with Harry 
Potter, the Daily Prophet is the 
main newspaper publication of the 
wizarding world - the only rival 
being the often fantastical Quibbler 
peddled by Luna Lovegood and her 
father. Similar in function to that of 
a ‘muggle’, non-magical newspaper, 


AM, 


a Ez 


u 


the Daily Prophet shares the 
headlines of the world — with one 
major difference... the images move. 
Imagine using an animated GIF in a 
news blog, but on paper. 

With his videos to hand, Piet set 
about creating the newspaper by 
designing the front cover in Adobe 
Photoshop. Not only did this enable 
him to include personal references 
in the copy, such as mention of 
himself and his wife being spotted 
at the theme park, but it also 
allowed him to create the perfect- 
sized window for the Raspberry Pi 
7-inch display that he was to fit 
within the frame. “First, I designed 
the whole poster in Photoshop. 
Within the design, I marked an area 
with the exact size of the Raspberry 
Pi screen. Next, I plotted the poster 
on normal paper at 100 percent, so 
the marked area still matched the 
Raspberry Pi screen. 

From there, Piet marked out the 
measurements of the screen onto 
the hardboard of a poster frame, 
giving him a guide to cut through for 
the additional electronics. 

Luckily for Piet, on the other side 
of the wall from where he would 


The Raspberry Pi 7-inch screen 
was the perfect size to act as 
the Lead headline photograph 


be hanging the frame was a small 
cupboard. He was able to dril 
directly through the wall, hiding any 
wires from view, and adding to the 
magical illusion of the piece. 
With on-board wireless 
connectivity on the Pi, the only wire 
needed was the USB power cable. 


The wiring is kept out of 
view to add to the illusion 
of the magic newspaper 


36 | MagPi June 2017 raspberrypi.org/magpi 


systemd-logind.service 


Above Both the glass of the frame and the bevel of the screen keep it fitted 


HARRY POTTER AND THE DAILY PROPHET 


snugly within the newspaper, with no need for glue or screws 


With this firmly in place inside the 
cupboard, Piet was able to remotely 
access the Pi and create the code to 
run his holiday footage. 

Piet created a simple Python 
script with two functions. The first 
detects the presence of someone 


Within the design, I marked an 
area with the exact size of the 
Raspberry Pi screen 


passing by, and the second then 
runs the holiday footage on the 
screen. To complete the first task, 
he used an IR distance sensor from 
Adafruit. This would detect motion 
within a set range around the 


photo frame. The motion sensor 
then triggers Omxplayer to play 
five minutes of footage before 
turning the screen off again. 

To add to the look and feel of 
the newspaper, Piet edited the 
footage to give it a grainer, sepia 


tone in line with the movie prop. 
He converted the footage to H.264 
so that it played through the 
Raspberry Pi, creating a beautifully 
executed and impressive magical 
holiday souvenir. 


= 


— 


Added texture and colour effects give the 
video the appearance of a Daily Prophet image 
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RASPBERRY PI 101: SET UP A FILE SERVER 


Turn your Raspberry Pi into a file server to back up and share content 
from anywhere on your local network 


A 32GB micro 
SD card 


Raspberry Pi 2/3 


> Monitor, 
keyboard and 
mouse (for 
setup) 


Wired Ethernet 
connection 


> NOOBS 
magpi.cc/ 
2bnf5XF 
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File Edit Search Options Help 


# printer drivers 
[print$] 
comment = Printer Drivers 
path = /var/lib/samba/printers 
browseable = yes 
read only = yes 
guest ok = no 
# Uncomment to allow remote administration of Windows print drivers. 
f You may need to replace ‘lpadmin' with the name of the group your 
# admin users are members of. 
# Please note that you also need to set appropriate Unix permissions 
# to the drivers directory for these users to have write rights in it 
; write list = root, @lpadmin 


An entry in /etc/samba/ 
smb.conf will create the top-level 
directory of your share 


This is the location of the 
folder we're going to share 


[share] 
comment = Pi shared folder 
path = /share 
browseable = yes 
writeable = yes 

only guest = no 
create mask = 0777 
directory mask = 0777 
public = yes 
guest ok = yes 


We've enabled guest access, so 
network users won't need a username 
and password to access the share 


F Ubrańe 


Documents 


Aus 


RASPBERRY PI 101: BUILD AN INTRANET WEB SERVER 


Build a local HTML server with Apache 
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Monitor, ebsite a the capacity c e 10085 v2 : 
keyboard, and Pees Rate R nan. sa. A dy © u 
mouse (for setup) umie] À ] ) wami Sim cot (o) Wires onlin hap #1) DK iA 


and an ideal de\ ment € 10 tifvx m EET z] 
Wired Ethernet A RIAA pei ZEL aan GaGa wii] 


LIM OS) ra is racy en tt nl 


connection 

I | IST | OT p St i o [© [Apart ef Deltan jeste for the Raspberry tm varian) a 
miero SD card ee een aes ; ja OB nana e 
with oper > = i ; 3 ha as A re ein is pot Ik Pa 
magpl.cc. =: orn 
2bnf5XF È o 


Your site's title, like its 
structure, is defined in the HTML 
code of the pages you upload to it 


This is the address 
of your new website 


Your new website 
(custard optional) 
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debian 


locumented 


doc/apache2/ README.Debian.gz. A 


High Contrast Cats 


STEP BY STEP 


Hello world 


Laura 


Raspberry Pi 


Raspbian 


guizero 
magpi.cc/ 
2pRlwtq 


Right Sliders are 
used to adjust 
the value of 
something, like 
the size of text 
displayed in 

the window 
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{Laura 


Display my name 


ie -display() 


File Edit Format Run Options Windows Help 
guizero import App, Text, TextBox, PushButton, Slider, Picture 


def say_my_name(): 
welcome_message.set(my_name.get( ) ) 


def change_text_size(slider_value): 
welcome_message.font_size(slider_value) 


app = App(title="Hello world") 
welcome_message = Text(app, text="Welcome to my app”, size=40, font="Times new r 
my_name = TextBox(app, width=30) 

update_text = PushButton(app, command=say_my_name, text="Display my name") 


text_size = Slider(app, command=change_text_size, start=10, end=80) 
my_cat = Picture(app, image="cat.gif") 


Everything above app. 
display ( ) appears on the 
screen and runs continously 
as an interface 


WITH GUIS 


Imports from the guizero 
module provide access to all 
the elements you need to build 
a graphical user interface 


In this tutorial you will learn how to make simple GUIs in Python 


UI stands for graphical user interface and it 

is pronounced ‘gooey’. If you have written 

Python programs before, all of your input 
and output will probably have been dealt with via text 
appearing on the screen or being typed in by the user. 
Adding a GUI to your program lets the user interact 
with it using buttons, dropdowns, text boxes, menus, 
and other familiar user interface controls. 

In this tutorial you will learn how to make simple 

GUIs in Python. 


>STEP-01 

Getting started 

Before you start, make sure that you have installed 

the guizero library. Open a Terminal window and enter: 


sudo apt-get update 
sudo pip3 install guizero 


Now open Python 3 (IDLE), click on File > New File, 
and save your file as gui_test.py. Add a line of code at 
the start of your file to import the App class from the 
guizero library: 


from guizero import App 


Now add two more lines of code to create an app and 
then display it on the screen: 


app = App(title="Hello world") 
app.display() 


Save your file and press F5 to run it. You should see 


a blank GUI window. Congratulations, you have built 
your first GUI app. 
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>STEP-02 

Adding widgets 

Let’s start adding content to the GUI. We will refer to 
items you can add to a GUI (such as text, text boxes, 
buttons etc.) as widgets. There are a couple of rules to 
follow when adding a widget: if you want to use anew 
type of widget, you must import it. The first line of code 
in your program looks like this: 


from guizero import App 


As an example, if you wanted to use the Text widget, 
you would add it to the import line, after App. 

We will ask you to import various types of widget 
throughout this guide. Each type of widget only needs 
to be added to the import list once, and then you can 
use it as many times as you want on your GUI. 

All code that creates a widget must be added 
before the event loop, which means between the 
line of code where you create the app, and the 
app.display() line of code: 


from guizero import App, Text 
# Add GUI widget code here 
app.display() 


This is because the line of code app. display() 
starts the event loop. The GUI will be waiting for the 
user to do things such as click on a button — these 
are called events. It will constantly check whether 
anything new has happened and automatically 
update the display if necessary. The event loop blocks 
later code (rather like awhile True: loop), so code 
written after the event loop will never execute. 

Throughout this tutorial, we will ask you to add 
widgets to the GUI, which means adding them 
anywhere between these two lines of code. 


>STEP-03 
Text widget 
Probably the simplest widget you can add is the Text 
widget, which displays some text on the screen. 
Add Text to the import statement (read the first 
part of step 2, ‘Adding widgets’, if you are not sure 
how to do this). 
Add a Text widget to the GUI (read step 2 again if 
you are not sure where to put this code): 


welcome_message = Text(app, text="Welcome 
to my app") 


Here we have created a Text widget with the 
name welcome_message. The first argument (in the 
brackets) tells the widget who its boss is! To be more 
specific, we are telling this Text widget that it will be 
controlled by the app object, which we created earlier. 
The first argument given to any widget always tells it 
the name of its boss (or ‘master’). 
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GETTING STARTED WITH GUIS 


Tutorial 


(Hello world 


© ME © | À tyhon342she] | A {gui test py -/home/ 


Run your code by pressing F5. You should see 
‘Welcome to my app’ displayed on your GUI. 

Did you notice that we could tell the Text widget 
what content we wanted it to display by specifying 
text="Welcome to my app"? This is called a 
keyword argument, because we have specified the 
keyword text and the value we want. We can specify 
other keyword arguments, too; just add them on to 
the end, separated by commas. 


welcome_message = Text(app, text="Welcome 
to my app", size=40, font="Times New 
Roman", color="lightblue" ) 


Here, we have used keyword arguments for the size, 
font, and colour (note the American spelling, ‘color’). 


You can specify any font your computer has installed. 


Colours can be specified as colour names, but not every 
possible colour has a name, so you can also use hex 
codes (e.g. #ff0000) to define colours. 


>STEP-04 
TextBox widget 
TextBox widgets are used to let the user type in data 
— abit like the GUI version of the input() function you 
may have used before. Here s how to add one: 
Add the TextBox widget to your import statement: 


from guizero import App, Text, TextBox 

Now add a TextBox to the GUI: 

my_name = TextBox(app) 

Run your code by pressing F5.You should see 
a small text box appear. There is a keyword 


parameter width which you can add if you wish 
to make the box wider. 


Above You can 


add text boxes to 
collect input from 


the user, such 

as their name or 
text to be used in 
the program 
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>STEP-05 
PushButton widget 
PushButton widgets create a button. When the button 
is pushed, a function is called. 
Before the code that creates the GUI app, write a 


function which will be called when the button is pressed. 


It is a good idea to put all of your function code at the 


start of your program, immediately after the import line. 


def say_my_name(): 
welcome_message.set( my_name.get() ) 


This function refers to the Text widget 
(welcome_message) and sets its value to what was 
typed into the TextBoxwidget (my_name). You can 
use the get() and set() functions with many 
widgets to retrieve their current value or set them 
to something new. 

First, add PushButton to your import statement. 
Now use this code to add a PushButton to the GUI: 


update_text = PushButton(app, 
command=say_my_name, text="Display my 
name" ) 


The first argument tells the PushButton that 
the app is its boss. Then we use two keyword 
arguments: command tells the button which function 
to call when it is pressed, and text is the text which 
will be displayed on the button. 

Press F5 to run your code. Type your name into 
the text box and then press the button. You should 
see your name displayed in large text at the top. 

You have now experienced the basis for how the 
event loop works. The GUI waits for an event (in this 
case, you clicking on the button) and it calls a function 
in response to the event. This function may contain 
code to change something on the GUI; if so, the display 
is updated accordingly. 


>STEP-06 

Slider widget 

A slider lets users move within a range of values easily, 

rather like moving a volume control up or down. 
Before the code which creates the GUI app, write a 

function that will be called when the slider is moved. 


def change_text_size(slider_value): 
welcome_message. font_size(slider_ 
value) 


This function has a parameter called slider_value. 
When the slider is moved, the current value of the 
slider will automatically be sent to the function, so 
we must give ita name. We have chosen to call this 
parameter slider_value. The code inside the function 
sets the font_size of the welcome_message to the 
current slider value. 
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GHEE Py 


. from guizero import App, Text, TextBox, PushButton, 
Slider, Picture 


02. 

03. def say_my_name(): 

04. welcome_message.set(my_name.get()) 

057 

086. def change_text_size(slider_value): 

07. welcome_message.font_size(slider_value) 
08. 

09. app = App(title="Hello world") 

10. 


11. welcome_message = Text(app, text="Welcome to my app", 
size=40, font="Times new roman", color="lightblue") 

12. my_name = TextBox(app, width=30) 

13. update_text = PushButton(app, command=say_my_name, 
text="Display my name") 

14. text_size = Slider(app, command=change_text_size, 
start=10, end=80) 

15. my_cat = Picture(app, image="cat.gif") 

16. 

17. app.display() 


qanquage 


>PYTHON 3 


Add Slider to the import statement. Now add 
the Slider code to the GUI: 


DOWNLOAD: 
magpi.cc/2pQLpvB 


text_size = Slider(app, command=change_ 
text_size, start=10, end=80) 


The command is the function that will be called 
when the slider is moved (i.e. the function we just 
created). Start and end values are specified for the 
largest and smallest values the slider can have. We 
Rave specified these so that the font does not get 
too large or small — the smallest it can be is 10pt 
and the largest is 80pt. 

Save your code and press F5 to run it. Move the slider 
from side to side and watch the size of the text change. 


>STEP-07 
Picture widget 
You can add pictures to your GUI, as long as they re in 
GIF format. Sadly, animated GIFs only display as stills. 
Find a picture in GIF format that you'd like to use, or 
save an existing picture as a GIF. Save the picture in the 
same folder as your gui_test.py Python file. 
Add Picture to your import statement. Now Add 
a Picture to the GUI: 


my_cat = Picture(app, image="cat.gif") 
Press F5 to run your code. You should see your 
picture appear on the GUI. You have now learnt how 


to use some simple GUI widgets. The full code for this 
tutorial is found in gui_test.py. 
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Strato Pi enhances the 5 @ 


Raspberry Pi computer 

with hardware features 

that make it suitable for 

use in professional M p 
E where Makes Raspberry Pi professional 
reliability and service 
continuity are key 
requirements. 


Now introducing CAN Bus support 


POWER SUPPLY 
9-65Vdc power supply, 
with surge and reverse 

polarity protection 


POWER RELAY 

1 power relay output with 
both normally open and 
normally closed contacts 


SERIAL INTERFACES ®& 
CAN bus and RS-485 
interfaces to connect 
to other field systems 


HARDWARE WATCHDOG 
Strato can reset or 
perform a power cycle in 
case of software failure 


CE/ROHS CERTIFIED 


REAL TIME CLOCK 
RTC with on-board 
lithium back-up battery 


Strato Pi can be safely 
installed in industrial and 
residential environments 


The Strato Pi line offers many 
different solutions, available as 


boards, DIN-rail modules or 
touch panels. 
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Tutorial WALKTHROUGH 


HC-SRo4 ultrasonic distance sensor 
detects the distance to an object, 
such as your hand 


Avoltage divider, comprising two 
resistors, is used to reduce the voltage 
of the Echo pin current to 3.3V 


The sensor has four connections to 
the GPIO header on the Pi, including 
5V power and GND 


THE RASPBERRY PI 
ULTRASONIC THEREMIN 


Build your very own theremin musical instrument using an ultrasonic 
distance sensor and a little bit of Python and Sonic Pi code 


HC-SR04 
Ultrasonic 
Distance Sensor 


magpi.cc/ 
2q3cZ9J 


Breadboard 
magpi.cc/ 
2q34ZFz 


Jumper wires 
magpi.cc/ 
2q2Kqcm 


theremin is a unique musical instrument that 
produces sound without being touched. 

In this tutorial, you will use an ultrasonic 
distance sensor to control the notes played by Sonic Pi. 

An ultrasonic distance sensor has four pins: Gnd 
(ground), Trig (trigger), Echo (echo), and Vcc (power). 

To use the sensor, you need to connect its Gnd pin to 
a GND (ground) pin on the Raspberry Pi, the Trig pin 
to a GPIO pin on the Pi, and the Vcc pin to the 5V pin 
on the Pi. 

The Echo pin is a little more complicated. It needs 
to be connected through a 330 ohm resistor to a GPIO 


Below Play the musical theremin by 
moving your hand up and down over the kit 


pin on the Raspberry Pi, and that pin needs to be 
grounded through a 470 ohm resistor. The diagram 
shows one suggested arrangement. If you’ve wired 
up the sensor as shown in the diagram, your echo pin 
is 17 and your trigger pin is 4. 

Click on Menu > Programming > Python 3 (IDLE), to 
open a new Python shell. Click on New > New File. The 
code to detect distance is listed in theremin1.py. Type 
it into your new file, then save and run it. 

The sensor.distance is the distance in metres 

between the object and the sensor. Run your code and 
move your hand backwards and forwards. You should 
see the distance changing, as it is printed in the shell. 


Getting Sonic Pi ready 

Sonic Pi will receive messages from your Python 
script. Open Sonic Pi by clicking on Menu > 
Programming > Sonic Pi. In the buffer that is open, 
you can begin by writing a live_loop. This is a loop 
that runs forever, but can easily be updated, allowing 
you to experiment. You can add a line to reduce the 
time it takes for Sonic Pi and Python to talk. 


live_loop :listen do 
set_sched_ahead_time! 0.1 


end 
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ULTRASONIC THEREMIN | Tutorial 


theremin! py 


from gpiozero import DistanceSensor 
from time import sleep FILE NAMES: 


theremin1.py 


>PYTHON 


P theremin2.py 
sensor = DistanceSensor(echo=17, theremin3.py 


trigger=4) 


DOWNLOAD: 
magpi.cc/ 
2qj7qTN 


Above The distance sensor sends out a high-frequency pulse while True: 
and measureshow long it takes the echo to reflect back. 


print(sensor.distance) 
Next, you can sync the live loop with the messages sleep(1) 
that will be coming from Python. 


e 


message = sync "/play_this" 
end live_loop :listen do 
set_sched_ahead_time! 0.1 
The message that comes in will be a dictionary, end 
containing the key :args. The value of this key will 
be a list, where the first item is the MIDI value of the 


e 
note to be played. theremin3.py 


live_loop :listen do from gpiozero import DistanceSensor 
message = sync "/play_this" from time import sleep 
note = message[:args][0] 

end from pythonosc import osc_message builder 


from pythonosc import udp_client 
Lastly, you need to play the note. 
sensor = DistanceSensor(echo=17, trigger=4) 


live_loop :listen do sender = udp_client.SimpleUDPClient('127.0.0.1', 4559) 
message = sync "/play_this" 
note = message[:args][0] while True: 
play note pitch = round(sensor.distance * 100 + 30) 
end sender.send_message('/play_this', pitch) 
sleep(@.1) 


You can set this live loop to play straight away, by 
clicking on the Run button. You won’t hear anything 
yet, as the loop is not receiving any messages. sensor = DistanceSensor(echo=17, trigger=4) 
sender = udp_client.SimpleUDPClient('127.0.0.1', 4559) 


Sending notes from Python 


To finish your program, you need to send note MIDI while True: 

values to Sonic Pi from your Python file. You'll need to print(sensor.distance) 

use the OSC library for this part. sleep(1) 
from gpiozero import DistanceSensor You need to convert the distance into a MIDI value. 
from time import sleep These should be integers (whole numbers), and hover 


around the value 60, which is middle C. Round the 
from pythonosc import osc_message_builder distance to an integer, multiply it by 100, and then add 


from pythonosc import udp_client a little bit, so that the note is not too low in pitch. 
sensor = DistanceSensor(echo=17, trigger=4) while True: 
pitch = round(sensor.distance * 100 + 30) 

while True: sleep(1) 

print(sensor.distance) 

sleep(1) To finish off, you need to send the pitch over to Sonic 

Pi and reduce the sleep time. The final code is listed in 
Now you need to create a sender object that can theremin3.py. Save and run your code and see what happens. 
send the message. If all goes well, you've made your very own theremin 
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LORRAINE UNDERWOOD 


Lorraine runs the Kendal Pi Jam. She is 
an Irish maker living in Yorkshire with a 
background in web development 
@LMcUnderwood 

magpi.cc/20vDD9z 


TEMPERATURE CONTROLLED 


l Give every day a colourful and useful start by displaying the outside 
ber ced temperature using coloured lights on your stairs 


hen you wake up in the morning, wouldn’t 
> 5V RGB strip you like to know whether you need to wear Set up the lights 


magpi.cc/ your woolly hat or your sundress? Now you can Firstly, work out which end is which on your RGB 
Goa find out on your way to breakfast, thanks to Lorraine’s strip. We are looking for the Data In end. It should 

> 5V mains stairlights project! The Raspberry Pi hidden under the be labelled as Din. In this strip there are five cables 
szalał aś stairs connects to the web and checks the temperature. coming from three connections: two from GND, 
2pF8cqi It then controls the strip of 240 lights running up the one from DIN, and two coming out of 5V. 

> Female jack stairs. If it’s colder than 0 °C, the bottom 35 lights come Connect the 5V wire to the ‘+’ block on the female 
connector plug on in white; under 5 °C, and the next 35 lights light up jack connector plug by placing the bare wire under 
magpi.cc/ in blue; and so on up to 25 °C and red, although that the terminal, then screwing the terminal down with 


2q9Hfi6 $ : y 
a a screwdriver. Connect the GND wire to the — block in 


the same way. Pull gently on both wires to check that 
they’re connected. 


probably won’t happen in Yorkshire, where it was built! 
> Male-to-female 
jumper wires i 
| 
\ 


This is the permanent 
springtime temperature 
in Yorkshire: less than 
ten degrees! 


INCRE DIBLE 
PROJECTS Ə Bo 


"ME Mm 


| 
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TEMPERATURE CONTROLLED STAIRLIGHTS 


>STEP-02 
Set up the Pi 
Connect the Din and GND wires to the male ends of 
the jumper wires. Connect the female end to the Pi as 
follows: Din to GPIO pin 18; GND to any ground pin. 

You could power the Pi through the other 5V wire, 
but this can be dangerous for the board; it is best to 
use a normal power supply. 

Follow the steps at Adafruit to install the NeoPixel 
library, rpi_ws281x: magpi.cc/1inRSyYk. 

Plug the jack connector into your power supply. Plug 
in the power supply and test your strip using the scripts 
from the examples folder for some shiny lights! 


>STEP-03 

Set up the weather API 

You will need a developer account for a weather API 

to get the outside temperature for your area. We used 
forecast.io as it allows users to request 1,000 forecasts 
per day at no cost: 


> Go to forecast.io 

> Select Developer 

> Select ‘Sign up’ to register an account 

> Once you confirm your email address, you will 
get a secret key: you will need this key in Step 4 


You could set up another Pi outside your house and 
get the real temperature for your neighbourhood. 
It depends on how much you want to spend on the 
project, and whether you trust the API’s accuracy. 


>STEP-04 

Let there be light! 

Download stairlights.py from the box at the top of 
this page to the home/pi directory and change: 


Line 6: enter your secret key. 
Line 7: change longi and lati to your longitude 
and latitude coordinates. You can use Google Maps 
to find them: right-click on your location and select 
"What's here? 

Set up a cron task to check the outside temperature 
every five minutes and update the lights. 

In a Terminal window, type: 

sudo -E crontab -e 

At the end of the file, enter: 

*/5 * * * * /usr/bin/python3.4 /home/pi/ 
stairlights.py 

@reboot /usr/bin/python3.4 /home/pi/ 
stairlights.py 


Save the changes. 
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>PYTHON 


DOWNLOAD: 
magpi.cc/Stairlights 


5V and GND go to the power source 
via the female jack connector plug. 
GND and DIN go to the Pi via the 
jumper wires 


>STEP-05 

Debugging your lights 

If the examples from the NeoPixel library didn't 
work, check all your connections. Make sure you have 
plugged the data wire into the correct GPIO pin on 
your Pi. Are you connected to Din or Dout? The lights 
ll power on Dout, but nothing will happen. 

If the lights are displaying strange colours, some 
people have reported the NeoPixel library not working 
with Pi’s setup for audio. See magpi.cc/20vIQhy. 
Make sure your script is running properly before 
adding it to cron. There’s nothing like sitting on your 
stairs waiting for five minutes for a cronjob that isn’t 
working to run! 


>STEP-06 

What next for your lights? 

We changed the cron tasks to stop the lights 
displaying through the night: 


=. 


W. 


*/5 7-21 * * * /usr/bin/python3.4 /home/pi/stairlights.py 
*/5 7-21 * * * /usr/bin/python3.4 /home/pi/nightynight.py 


...where nightynight.py is a simple script that turns 
the lights off using the first 26 lines of stairlights.py 
and this line: 


colorMe(strip, Color(0, ©, 0), ©, 239) 


Now, with astrip of lights on your stairs, you could 
play all kinds of games! 

Add some coloured arcade buttons for a quick 
reaction game. 

Maybe when your phone connects to the Bluetooth 
on the Pi, your stairs could flash a welcoming 
hello dance. Experiment and have fun! 
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Tutorial 


WALKTHROUGH 


MAKE [THE 


SAME GAME 


You click a shape, it disappears, the board adjusts, and you get a score; 


DATABASE 
OPTION 


You could 
save the high 


scores with 
an SQLite 
database. Can 
you figure out 
how to do it? 


that’s what Same is about! 


e are going to show you how to make a simple 

game called Same. Same consists of different 

coloured balls arranged on a board. Balls of 
the same colour are joined together by connecting 
squares, and together they form a shape. When any 
part of this shape is clicked, it disappears and the balls 
above take the place of the now removed balls. 

We are going to be coding all of this from scratch 
using Pygame. By the end of this tutorial, you should 
be able to make your own modifications and make this 
game truly your own. How cool is that? 


¢ You click shapes to play the game. This one in particular is a good choice... 
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Code structure 

The code for this project is quite large, so we’ll assume 
you know how to do simple things in Pygame, such as 
draw a circle. What we’ll focus on instead is how you 
should think when you are tackling a program project 
similar to this. Before we begin, get the code at: 
magpi.cc/20Il4yM. Use python Gui.py to start a game. 

The first thing you want to do with a project like 
this is to think through what you want to do. As 
your programs begin to get more complex, the more 
important this step becomes. We will be making 
use of the model-view-controller (MVC) pattern to 
structure our program. The model refers to permanent 
data, the controller is where the main stuff happens, 
and the view is what the user sees. All our controller 
code is going to be found in the logic. py file (used 
for scoring, the internal representation of the board, 
and other functions for tasks like removing balls and 
finding shapes). 

The Gui.py file contains all the code that is related 
to the view. It has code to draw balls and connecting 
squares on the screen, based on the internal 
representation of the board found in the logic.py 
file. It also has code to draw the scoreboard, and 
deals with events as they happen. For the model, we 
have included it in the logic.py file. The only thing 
permanently saved between different games is the 
high score. This is stored in the TopScores.txt file. We 
access this data with getHighScore( ) and update the 
high score if we need to with updateHighScore(). 


|_ These functions are found in the logic.py file, but they 


belong to the model. 


g Same-coloured balls together 
create shapes. Look out for them 
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Gui.py Depends on: 


Contains: 


> Game display class 


> Displays the board based on the 
representation in the Board class 


> Figures out which ball was clicked 
and uses the remove method in the 
Board class to remove the shape 


Game logic 

Now we have an idea of how our code is going to be 
structured, let's discuss some implementation details. 
We represent the board as a two-dimensional list of 
balls called, surprisingly, balls. This makes it easy to 
access the ball at position x,y with balls[x][y]. 
Another critical task we need to be able to do is to 
group similarly coloured balls into a shape. This is done 
by checking up, down, left, and right to see whether 
the balls at those positions are of the same colour (the 
_adjacent() function does this ). _findAdjacent() is 
then used to find all the balls that belong to a shape. 
The _markBalls() function is used to mark a shape for 
deletion, while _clearBalls() deletes the shape. The 
_findAdjacent() function is also used to calculate the 
number of balls that were removed and hence is used to 
calculate the score in getScore(). 


Displaying the board 

Now we have created logic.py, we can now develop the 
code that draws things on the screen and responds to 
clicks. This is where Pygame does its magic. All the 
code that displays stuff can be found in _display(). 
It makes use of a function to draw the square of 
different colours. It draws the board and also draws 
the connecting squares. 
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MAKE THE SAME GAME 


logic.py >PYTHON 


Contains: FILE NAMES: 
Logic.py 
Gui.py 


> Board class 
DOWNLOAD: 
> Has a Board attribute magpi.cc/2oll4yM 


> Balls get removed from the 
board here 


> Computes the current score 


Above The code flow is fairly simple and it depends 


mostly on two scripts FURTHER 
Reacting to events MEROVERENTS 
Besides displaying objects on the screen, our game We can add 
needs to react to events. We need to know which ee 
ball was clicked, so we use _getPosition(); this the colours of 
returns the x,y position if a ball was clicked, and the balls, we 
None if the click wasn’t on a ball. After we have ea 
identified which ball was clicked, we remove all the game is 


balls belonging to that ball’s shape. This is done with scored and 
the _removeBalls() function in logic.py. The event- M RS 
handling loop is in the run() function. This updates 

the board frequently after any event has occurred. 


Permanent game data 

The only thing that is being permanently remembered 
by our game is the high score. This has been 
implemented using a file. Another robust approach 
would be to use an SQLite database to store several 
high scores. 


Releasing to the world 

Our game is working now, but there are still some 
finishing touches we are going to add. We want to 

be able to share our game with our friends as easily 
as possible. One way to do that would be to create 

an executable that contains our game, and then any 
player just needs to click on the executable to play 
the game. No extra downloads! To do this, we need to 
install pyinstaller. This is achieved by entering the 
following command: 


pip install pyinstaller 


To create our package in the Terminal and in the 
same directory as our game, we run. 


pyinstaller Gui.spec --windowed -onefile 


Voila! We have an executable we can share with 
all our friends. Pyinstaller can create executables for 
other operating systems, too, so nobody misses out! 


Left After one move, the red ball drops down 
and creates a shape with the other red ones 
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A simple, visual calendar reminder using a Raspberry Pi Zero W, Blinkt! 
LED strip, and the Google Calendar API 


t's easy to get distracted at work and miss the 

Google Calendar reminders on your desktop 

and smartphone, especially if you have back- 
to-back meetings. To help avoid missing meetings, 
let's create a Pi Reminder project, a visual notifier that 
uses the Raspberry Pi and a bunch of LEDs to remind 
you about upcoming appointments. Being visual-only, 
it has the advantage of not interrupting important 
phone calls or chats. The new Pi Zero W and Blinkt! 
have everything you need in a small, unobtrusive 
package. An easy project with very little setup. 


Notifications 

The Pi connects to a Google Calendar account every 
minute and checks for upcoming appointments. When it 
finds one, it flashes the Blinkt! LEDs for following alerts: 


White @ 10 minutes until 5 minutes 
Yellow @ 5 minutes until 2 minutes 
Orange @ 2 minutes 


You can easily change the code to flash the lights in 
any colour or pattern you want. 


Implementation 
To assemble the hardware, follow the setup instructions 
for the Pimoroni Pi Zero W Starter Kit. Next, download 
the latest version of the Raspbian OS from the 
Raspberry Pi website (magpi.cc/2ejN6sk) and follow 
the installation instructions at magpi.cc/1XTmymk. 
Insert the SD card into the Pi, connect a keyboard, 
mouse, and a monitor to the Pi using the cables that 
come with the starter kit, and, finally, power it up using 
a smartphone charger or some suitable power source. 
Connect the Pi to your Wireless network using the 
instructions at magpi.cc/2qyyUSX. 

When the Pi is connected to the network and 
ready to go, open a Terminal window and update the 
device’s software using the following commands: 


sudo apt-get update 
sudo apt-get upgrade 


Install the Blinkt! Python libraries and example 
applications by executing the following command: 


curl -sS get.pimoroni.com/blinkt | bash 
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MAKE A VISUAL APPOINTMENT REMINDER 


Next, download the project source code. In the 
Terminal window, execute the following command: 


git clone https://github.com/ 
johnwargo/Pi-Remind-Zero-Blinkt 


This will download and extract the project source 
code to the Pi-Remind-Zero-Blinkt folder. Change to 
the new folder using the following command: 


cd Pi-Remind-Zero-Blinkt 


Before you can use the project’s software, you must 
set up an account with Google so the app can consume 
the Google Calendar APIs. To set up your account, 
read the Google Calendar API Python Quickstart at 
goo.gl/Ay4AQg and follow its instructions to create 
your account. 

Create a new Google Calendar API application, 
then download the application’s client secret to a file 
called client_secret.json in the reminder project’s 
folder. Be sure to name the downloaded file using 
that file name. You'll need it to authorise the app to 
access your Google Calendar, and that particular file 
name is hard-coded into the project’s main Python 
app (remind.py). 

Now, install the Google Calendar API Python files 
(goo.gl/os20r7) along with some other required 
libraries using the following command: 


sudo pip install --upgrade google- 
api-python-client python-dateutil pytz 
httplib2 oauth2client 


With everything in place, execute the reminder app 
using the following command: 


sudo python ./remind.py 


The application will launch, validate its configuration, 
and then warn you that there’s additional configuration 
that must be completed, as shown in Fig 1. 

Before the app can access the calendar, you’ ll need 
to authorise the app to use the Google Calendar API for 
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Fig 4 Initial loading of the Pi Reminder app requires access to 
your Google Calendar account 
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Google john@johnwargo.com ~ >PYTHON 


DOWNLOAD: 
magpi.cc/2o0vAPJz 


~ Pi Reminder would like to: 
a View your calendars 


By clicking Allow, you allow this app and Google to use your information 
in accordance with their respective terms of service and privacy policies 
You can change this and other Account Permissions at any time 
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Fig 2 You must authorise the Pi Reminder application to access 
your Google Calendar 

your calendar account. The browser will launch and walk 
you through the process. It starts by prompting you to 
log in to the Google account for the calendar you want 
the app to monitor. Enter the email address associated 
with that account and work through the authorisation 
process until the browser prompts you to approve the 
application’s access to your calendar (Fig 2). Be sure to 
click the Allow button to authorise access. 

At this point, the application will access 
your calendar and start notifying you of your 
upcoming appointments. 

Remember though, if you ever change Google 
calendars (from a work to a personal calendar or from 
one work calendar profile to another), you Il need to 
whack the existing access token created during the 
initial startup of the Pi Reminder app. Instructions for 
deleting the token are available at magpi.cc/2qyMupl. 


+ 


Starting the reminder 

application automatically 

Now that you have the application running, let’s 
configure the Pi to start the application at boot. 
Press CTRL+C to kill the running reminder 
application. Now, make the project s Bash script file 
executable by executing the following command: 


chmod +x start-remind.sh 


Open the pi user's session autostart file using the 
following command: 


sudo nano ~/.config/1xsession/LXDE-pi/ 
autostart 


Add the following line to the end (bottom) of the file: 


Qlxterminal -e /home/pi/Pi-Remind-Zero- 
Blinkt/start-remind.sh 


Save your changes: press CTRL+O, then the ENTER 
key. Next, press CTRL+X to exit the application. 

Reboot the Raspberry Pi; when it restarts, the 
Python remind process should execute in its own 
Terminal window. 
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> Apple or Android 
mobile device 


(optional) 


> TouchOSC app 
(only needed 
if you havea 
mobile device) 


> Raspberry Pi 3 


Make great polyrhythmic music controlled from your mobile device 


hat is a hexome and why would you want to It was unique at the time, although its phenomenal 

emulate it? Well, a hexome is a monome laid success in music making and production ensured that 

out on a hexagonal grid - which is allverywell there are now many commercial copycat variants of 
if you know what a monome is. the concept. The idea was that in itself the monome 

Brian Crabtree and his partner Kelli Cain created had no function and made no sound: any function it 

the monome in 2006, and the first model was an did achieve was controlled by an external program 
undedicated matrix of illuminated push buttons ina running on some computer. This meant it could 
square or rectangular grid formation. be used for anything you wanted. What was fixed, 


Fig 1 The real Hexome 


Duplicate display on screen 


Volume control 


Sound mapping change 


however, was the key and light numbering, so that 
any program written to use on one monome would 
work on any monome, and those commands were 
sent by OSC messages. 

We looked at OSC messages last month and saw how 
these could be handled by a tablet and an application 
called TouchOSC. This month we look at how it can 
emulate a hexome — oh, and the reason you might 
want to emulate one is that it took us three years to 
build the original! 


The hexome 

Fig 1 shows what the original hexome looks like. 

If you want to build your own hexome, we have 
published all the details, software, and CAD files at 
magpi.cc/2ph7XVS. You will also find examples of 
more conventional monomes on the site. 

The hexome differs in two major ways from the 
conventional monome: first, there’s the hexagonal 
layout; second, the illuminating LEDs are not 
monochrome but RGB. The key numbering presented 
a bit of a problem because in a conventional grid 
there is a natural x-y Cartesian system that is easy to 
extend as the monome gets bigger. With a hexagonal 


Note position 


Current step position 


arrangement it is not so straightforward. While 

you could use polar coordinates, it is not always 
satisfactory on this coarse scale. We decided to opt 
for the most straightforward but least useful simple 


This tool could affect, maybe 
even guide, music creation 
in anew and unusual way 


numbering from the top left corner. This gave the 
freedom to use many different types of coordinate 
system depending on the application. All you have to 
do is to write the appropriate look-up tables to get 
to the raw key numbers. The key numbers are shown 
in the diagram for step 3 (page 59) in the guide for 
creating the TouchOSC layout. 

It is an observation, often made by musicians, that 
the tools you use determine the sort of music you 
make. So part of the appeal in creating the hexome 
was to see how this tool could affect, maybe even 
guide, music creation in a new and unusual way. 
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After several experiments, we found one surprising 
system that produced a unique form of sequencer, and 
this is what we are presenting here. It is what we like 
to call a polyrhythmic sequencer. 


Polyrhythmic sequencer 

Around the central key in a hexagonal grid is a circle of 
six hexagons; around that is a circle of 12, around that 
a circle of 18, and finally around that a circle of 24. If 
you number the rings as shown in Fig 2, then any ring 
Rn has the number of keys in Rn given by: 


Rn= Rn-1+ 6 


...where Rn-1 is the number of keys in the 
previous ring. 

If each key in a ring is one point in a sequence, 
and each ring runs at the same sequence step time, 
then we have in effect four sequences of different 


length running at the same time. So the sequence 
taken as a whole will be much longer than the 

length of the longest sequence. In the case of our 
four-ring hexome, this is a sequence length of 72 
before the sequence repeats. Fig 3 (overleaf) shows 
this sequence: each ring has its own length, and each 
step is represented by different colours and shades. 
These are shown separately in the list at the top, and 
their interaction is shown underneath. Note that the 
inner ring, the six-step sequence, has to repeat twice 
while the next ring, the 12-step one, makes one cycle. 
Then we need three of the 12-step cycle to exactly 
align with two cycles of the next ring, the 18-step one. 
Finally, we need three cycles of the 24-step cycle to 
exactly line up with four cycles of the 18-step cycle. 
This give 72 steps in all, or the length of the longest 
sequence multiplied by the lowest common factor of 
all the rings — this is what a polyrhythmic sequencer 
is all about. 


Fig 2 Ring numbers 
on a Hexome 
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>STEP-01 
Set up the faders 


If you haven't done so yet, install the 
TouchOSC editor: see last month's project 
for installation instructions and help with 
selecting the various TouchOSC elements. 
Set up two faders on the right-hand side, 
both 50 wide and 304 high. Fader 1 should 
have a range of 0 to 18 and fader 2 a range of 
0 to -40. Both should have the inverted and 
centered boxes ticked. Fader 1 should be at 
X=948, Y=17 and fader 2 at X=948, Y=394. 


Implementation 

Again, as last month, we are going to use the 
Processing language. If you haven’t done so already, 
install it by typing: 


curl https://processing.org/download/ 
install-arm.sh | sudo sh 


You also need to install two libraries. From the 
Sketch menu, go to the Import Library entry and 
choose Add Library, then search for oscP5 and install 


E © 


Open 


B xX 


Save As Cut 


Name: faderl 


Color: Gray t 


MIDI 
OSC: v auto 
1/faderl 
Value Range 


From: 0° To: 18 


v Inverted 
v Centered 


Response: 


Absolute © 


accessed directly from the Pi through either a key press 
or a mouse click. Sadly, the TouchOSC does not have 
hexagonal LEDs, so we have to make do with circles. 


The samples 

At each point in a sequence, a sample is triggered, 
or not, depending on whether the current key has 
been selected by previously clicking it. Each ring 
only triggers one sample, although the mapping 
between the rings and the samples they trigger can 
be changed by the push buttons on the left-hand 


At each point in a sequence, a sample is triggered, or 
not, depending on whether the current key has been 
selected by previously clicking it 


that. Then repeat and install the Minim library; this 
is the one that will play the sounds. If you try to run 
some of the examples from the Minim library, you 
will get an error complaining about the libgles2-mesa 
module and asking you to remove it. It is not 
necessary to do this for this project, only for running 
some of the examples. Note that if you do uninstall 
the libgles2-mesa, it is likely to affect the operation of 
Sonic Pi — and as we said, there is no need to remove 
this module for this project. 

Download the ZIP of the code for this project from 
GitHub: magpi.cc/1NqjjmV. Note that while it can use 
TouchOSC for easy control, most of the functions can be 


side of the TouchOSC display or by the keys 0 to 9 on 
the keyboard (see step 2). This mapping is important 
for determining the type of melody you can produce. 
The first four change the mapping in thirds in the key 
of C for a harp, and the second four the same thing 
for a marimba. The last two are percussion samples 
and have no harmonic relationship. We found the best 
results were obtained with the smaller circles mapped 
to the lower notes. One important thing to note is 
that these samples can be played at the same time. 

If the sample from each waveform at any instance 
exceeds the 16-bit sample size, this will result in 
clipping of the waveform, which will sound like clicks 
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Color: Gray S 
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Y: 60 © H: EJ © 


MIDI Key 


OSC: v auto 
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From: JO To: li. 


in the sound. To avoid this, the samples should be 
normalised, to a level of -10dB. You can do this 

by using the Audacity application and selecting 
Normalise in the Effects menu. This has already 
been done with the samples that come with this 
program, but you will have to do this if you want to 
add your own samples. 


v Local feedback off 


The controls 

The speed of the sequence and its volume are 
controlled by two sliders on the right of the iPad 
screen. If you are not using a mobile device, then 
the Pi’s keyboard can be used to change the speed. 
The F key makes it go faster and the S key slower. 
This changes the number of video frames that have 
to pass before the sequence is advanced. The other 
control, the clear button, is the central key of the 
display, which is set to red. 
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IF 
Add the LEDs 
Select an LED object and size to 80 by 80. Place 


it at X=350 Y=48, then copy and paste and change 
the locations to those shown in the diagram. 


Note that the X and Y values define the corner of 

a circumscribed rectangle around the circle; the 
LED number is shown in the circle. If you get mixed 
up, you can always relabel them after all the LEDs 
are created. Save the layout and transfer it to your 
mobile device: see last month for details. 
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Taking it further 


You can add a keyboard volume control to the 
program if you like, but the major change you 

can make is to the samples. You can change the 
mapping, that is which sample corresponds to 
which ring, by changing the noteLookUp arrays in 
the ‘notes’ tab of the code. This is quite easy to do. 
More complex is to change the sample instruments, 
although this is not too difficult if you examine the 
code and see how the samples are loaded in. The 
sample names are just numbers, taken from the 
MIDI note number of the pitch of the sample. 


>PROCESSING 


DOWNLOAD: 
magpi.cc/1NqJjmV 


PROJECT 
VIDEOS 


Check out Mike's 
Bakery videos at: 
magpi.cc/1N qJnTz 
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Gy ey x se~ glm 4ja 4 
A ma 
Symbols |> | circle.c X | 
#include <stdio.h> 
=| PF 
gp Functions puna e own 
© main [4] 
@ Macros void main (void) 
i í 
@ P! (2) float rad = 3; 


Status 


KEEP NAMES 
CONSISTENT 


While you can 
call header files 
whatever you 
like - there's no 
magic about 
the names - it's 
good practice 
to give the 
header file for 
the functions 

in a particular 
C file the same 
name as the C 
file itself, with 

a .h extension 
rather than .c. 
This makes 

it easier for 
someone 
reading your 
code to find 
the files where 
functions 

are defined. 


#DEFINE 
FOR TEXT 


If using #define 
for text strings, 
they should 

be enclosed in 
double quotes, 
otherwise the 
replaced text 
will end at the 
first space. So 
use #define 
MY_TEXT 
"This is 

some text to 
replace." 
The double 
quotes are 
included in the 
replacement, 
so you can then 
just call printf 
(MY_TEXT) ; 
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rem 
NK COODNOUSLWNHY 


All preprocessor directives, 
= like #define, start with a # sign 
16:37:16: This is Geary 


16:37:16: File /home/pi/circle.c opened(1). 


float circ = rad * 2 * PI; 
float area = rad * rad 
printf ("The circumfere 
printf ("The area of a 


circle radius %f is %fin", rad, circ); 
*, rad, area); 


Every use of pi is replaced 
by the value in the matching 
#define directive 
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AN INTRODUCTION TO C 


HEADER FILES AND 
THE PREPROCESSOR 


Splitting code up into multiple files 


he examples so far have put the code for a 
program in one file. But once programs get 
big, it's useful to split them up into separate 
files. To understand how this works, we need to look 
in more detail at what the compiler actually does. 

Calling gcc on a single source file creates a single 
executable program. gcc actually does two things: it 
first compiles the C source file into an object file, and 
then it links the object file with the library functions to 
create the executable. This second step is performed 
by a program called a linker; gcc does both jobs. 

If a program has multiple source files, you need to 
include the names of all the source files in the call to 
gcc. It will then create one object file for each source 
file, and then link all the object files together to 
create the executable. 

However, if you’ve separated your code into 
separate files (usually referred to as modules), you'll 
have some files which make calls to functions in 
other files in order to work. These files don’t find out 
about each other until the linker operates on them; 
the files are compiled individually, and the compiler 
will complain if you use functions in a file it doesn’t 
know about. 

We fix this using header files; files with the 
extension .h which hold the declarations of 
functions defined in a module, so that the compiler 
can be told about them when they’ re used by another 
module. We’ve already seen this; the line #include 


<stdio.h> at the top of the examples is telling 
the compiler that functions declared in the system 
header file stdio.h are used in this module. 


Splitting code into multiple files 
Here’s an example. Create three files, two with the 
extension .c and one with the extension .h, as follows: 


function.c 
int add_vals (int a, int b, int c) 


{ 


return a +b + c; 


} 


function.h 
extern int add_vals (int a, int b, int c); 
main.c 


#include <stdio.h> 
#include " function.h" 


void main (void) 
{ 
printf ("The total is %d\n", 
add_vals (1, 2, 3)); 
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Inside the header file we declare the function with 
the word extern at the start of the declaration. This 
tells the compiler that this function is to be found 
externally to the file, i.e. in another C file. 
Put all three files in the same directory and run 
gcc -o myprog main.c function.c. 
The resulting program runs the main function 
in main.c, which calls the add_vals function 
in function.c. 

The symbols around the name of the included 
file tell the compiler where that file is. <> signs 
tell the compiler to look for the file in the directory 
where the system’s include files are stored; "" signs 
indicate a local file in the same directory as the .c 
files, so use "" signs around the names of your own 
header files when including them. 


The preprocessor 

#include is an instruction to the preprocessor: the 
first stage of compiling, which substitutes text 
within source files before passing them to the 
compiler itself. The preprocessor is controlled with 
directives, which start with a # sign. 

#include instructs the preprocessor to replace 
the line with the file being included. So the line 
#include "function.h" in the .c file gets replaced 
with the contents of function.h, meaning that 
what’s passed to the compiler is: 


#include <stdio.h> 
extern int add_vals (int a, int b, int c); 


void main (void) 
{ 
printf ("The total is %d\n", 
add_vals (1, 2, 3)); 
} 


#define 


#define can be used to define constant values. 


#include <stdio.h> 
#define PI 3.14159 


void main (void) 
{ 
float rad = 3; 
float circ = rad * 2 * PI; 
float area = rad * rad * PI; 
printf ("Area of circle radius %f: %f\n", 
rad, area); 
printf ("Circumference of circle: %f\n", 
rad, circ); 


PI isn’t a variable; it’s text that will be 
substituted by the preprocessor. The #define tells 
the preprocessor to go through the file and replace 
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© main [3] 


void main (void) 
{ 


zit o 
printf (*Some żewn*); 
#else 
printf ("Some other [eode\n"); 
fondit 


[ sm 16:37:16: File Momeypiicircie.c openedi1) 
tatus 
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col 24 sel: 0 INS TAB mode: Unix (LF) encoding: UTF-8__ filetvpe €__ scope: ma 
every instance of the symbolic constant PI with the 
digits 3.14159 before passing it to the compiler. (A 
line which does something likePI = 5; will cause 
an error; the compiler will see the meaningless 
statement 3.14159 = 5;.) 


You can also #define functions: 


#include <stdio.h> 
#define ADD(a,b) (a+b) 


void main (void) 
{ 
printf ("The sum of %d and %d is %d\n", 
5, 2, ADD(5,2)); 
printf ("The sum of %d and %d is %d\n", 
3, 7, ADD(3,7)); 


Whenever ADD(a,b) appears in the code, it's 
replaced by (a+b), with the valuesof aandb 
replaced by the arguments to ADD. 

The preprocessor can also evaluate conditions 
with #if: 


#include <stdio.h> 


void main (void) 


{ 
#if o 

printf ("Some code\n"); 
#else 

printf ("Some other code\n"); 
#endif 
} 


With a O after the #if, the code between the 
#if and the #else doesn’t get called, but the code 
between the #else and the #endif does. If you 
change the value after the #if to a 1, the code 
between the #if and the #else does get called, but 
the code between the #else and the #endif doesn’t. 
This is useful to temporarily remove or replace 
a piece of code when you re debugging. 
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Left The most 
common use 
of #if is for 
temporarily 
removing code 
-just wrap it 


between an #if 
O and an #endif. 


The #else is 
optional, but 
sometimes you 


want to substitute 


the code you've 
removed with 
different code 


MAKEFILES 


As you can 


imagine, if you 
have a project 


with tens or 
hundreds of 
C files, typing 


all their names 


in the call to 


gcc every time 


would be a 
bit tedious! 


Large projects 


are built with 
a tool called 
‘make’, which 
stores build 
instructions 
in a ‘Makefile’ 
Makefiles are 
beyond the 
scope of this 
guide, but 


there's lots of 


information 
about them 
online. 


LEARN MORE 
ABOUT C 


If you've been 
enjoying these 


introduction 
to C tutorials, 
then check 
out our Learn 


to Code with C 
book for more! 


magpi.cc/ 
learn-c-book 
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ə Aswhen using say, 
the ask command 
results ina 
speech bubble 


* The Nano 
sprite has four 
costumes, which 
are alternated to 
animate him 


* The ask command 
also brings up a 
text input field for 
the user to enter 
their answer 


Nano the cute robot loves to chat. He Il respond to your answers, 
and he ll even jump up and down if you ask him to... 


or this project, you'll be creating your own 

talking robot which responds to your text 

input. We'll also alter his expression by 
switching between different costumes. We’ll be 
using ask commands, if..else blocks, and the join 
Operator. We’ll also create a variable to store the 
user's name — variables are really handy for storing 
values to use elsewhere. That's enough chitchat — 
let's start up a new Scratch project... 


We create a variable to store the user's name and then 
repeat it within Nano's speech 


Prepare your artwork 

After deleting the Scratch cat by right-clicking on 

it and selecting Delete, it's time to import a new 
stage background (space) and our character sprite 
(Nano). You can either obtain these from the Scratch 
2.0 library or, in Scratch 1.4, download them from 
magpi.cc/scratch_art. In the latter case, click Stage 
in the Sprite List, select the Backgrounds tab, then 
click Import and navigate to Space.png in the folder 
where you’ve stored the downloaded graphics for 
this project. Next, click the star/folder icon above 
the Sprite List, then navigate to the same folder and 
import Nano.sprite. If you click the Costumes tab, 
you’ ll notice that Nano has four of them; we'll switch 
between them to animate our little robot friend. 


Ask for a name 

First, we’ll get our robot to ask for the user’s name and 
then use it ina response. With the Nano sprite selected, 
click the Scripts tab (top middle) and add the code from 
Listing 1. Note that instead of using a standard when 
green flag clicked block, we’re starting the program 
when the Nano sprite is clicked. He then asks for the 
user’s name, which is stored in a variable called name. 
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CHATBOT 


Above: By switching between four costumes, we can alter our 
character's facial expression 


First, we need to create the latter: select Variables from 
the top left, then click ‘Make a variable’, ‘For this sprite 
only’, and enter ‘name’ in the text field. Untick the name 
block to stop it showing on the stage. We can now set 
name to answer (the user’s text input) and then add it 
into Nano’s response by using the join Operator block. 
Make sure you put a space after ‘Hi’ to avoid it being 
joined together with the name. 


>STEP-03 

Add a question 

Next, we’ll add some more blocks from Listing 2 to 

the bottom of this script. After saying ‘hi’ to them, 
Nano asks the user if they’re OK. Again, we use the ask 
Sensing block for this, and the name variable to refer to 
them by name. We then use an if...else Control block 
to determine Nano’s response based on the user’s input. 
If it’s ‘yes’ (which we test for using the = Operator) we 
switch Nano’s costume to happy nano-c, using the 
drop-down box on his Looks block. We also get him 

to say ‘That’s great to hear!’ 


>STEP-04 

Else this... 

In the else part of the if..else block, we determine 
what happens if the user’s input isn’t ‘yes’. In this 
case, we’ll switch Nano’s costume to the frowning 
nano-d and get him to say ‘Oh no!’ Test out this code 
with different inputs to check that it’s working as 
expected. Note that while the user’s text input isn’t 
case sensitive, it has to be just ‘yes’, with nothing 
added, in order to be recognised as such. 


>STEP-05 

Jump up and down 

Finally, we’ ll add another question with ask, using a 
standard if block to make Nano jump up and down 
or not. Add the blocks from Listing 3 to the script. We 
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when Nano clicked >SCRATCH 


switch to costume nano-b | 
mAr What's your name? ere EVES: 


set name to answer 


say join [Mi] name for () secs 


ask join Are you OK name = and wait 


answer = yes 


switch to costume Nano-c | 
ery al That's great to hear! ER 2 JE 


else 


switch to costume nano-d 
say AEM for @ secs 


FARI Would like to see me jump? ENU ITEN: 
answer = yes. 


switch to costume Nano-c | 


change y by 10) 
wait [0.1 secs 
change y by 
wait [0.1 | secs 


LEARN MORE 
SCRATCH! 


Want to make 
other Scratch 
projects? Then 
check out our 
Learn to Code 
with Scratch 
book for many 
more ways to 
use Scratch: 
magpi.cc/ 
Scratch-book 


use a repeat loop to make Nano move repeatedly up 
and down, to jump. To make sure he’s not frowning 
from the previous response while doing so, we switch 
his costume to nano-c before the repeat loop. 


>STEP-06 

Taking it further 

You can alter the example questions or add any extra 
ones you want, even getting Nano to tell a joke. You p 
could also add extra costumes by copying and editing 
them in the Paint Editor, or even a design a brand new 
sprite with various costumes. 


Magi 
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SCRATCH 
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FREQUENTLY 
ASKED QUESTIONS 


YOUR QUESTIONS ANSWERED 


NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 
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Analogue 

The main audio output on the Raspberry Pi is the 

3.5 mm headphone jack, which also supports video 
out. This provides analogue audio out when the task 
requires it. Normal headphones and mini speakers 
that connect with a headphone cable can be connected 
to the headphone jack. 


Digital 

The HDMI port provides a digital audio output, and is 
also the main video out port. It’s a bit tricky to split up 
the audio and video signal without special equipment, 
but it’s the highest quality audio out on the Raspberry 
Pi by default. 


Bluetooth 

Bluetooth speakers or headphones connect to older 
models of the Raspberry Pi via dongles, but connecting 
via Bluetooth has become a lot easier since the 
introduction of the Raspberry Pi 3 and its radio chip. 
You will need to take some steps to get it working. 


Connect the speaker 

Next to the wireless LAN icon on the toolbar is the 
Bluetooth logo for managing Bluetooth devices. Start 
the syncing sequence on your Bluetooth audio device 
and then scan for devices in this manager to connect 
to your speakers or headphones. 


Get PulseAudio 

Install PulseAudio with sudo apt-get install 
pulseaudio pavucontrol pulseaudio-module- 
bluetooth in the Terminal. You'll need it to connect 
the audio to the Bluetooth speakers. To be safe, you 
should now reboot your Raspberry Pi. 


Play over Bluetooth 

Reconnect your audio device after reboot and check the 
Volume Control option in Sound 8 Video in the main 
menu. On output devices, it should list 'bcm2835 ALSA’ 
as the default output. Pick the Bluetooth audio device 
once it has connected, and you're ready to go. 


Upgrading on-board audio 

You can’t upgrade the standard HDMI or the 3.5 mm 
jack on the Raspberry Pi, as they are integrated parts 
of the system. It is unlikely that you will need to 
update the HDMI, as it's a high-quality digital output. 


Add-on board 

There are several add-on boards for the Raspberry Pi 
that vastly improve the audio output. These DAC HATs 
are made by various firms and you can buy them at 
online retailers such as Pimoroni, The Pi Hut, etc. 


Recording 

Currently there's no way to actually record audio on 
the Raspberry Pi unless you plug in a USB device or 
HAT that includes a microphone. This iswhy thePi 
Camera Module doesn’t record sound when you're 
filming with it. 
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YOUR QUESTIONS ANSWERED 


FROM THE RASPBERRY PI FAQ 


RASPBERRYPI.ORG/HELP 


What is the Camera Module? 

The Camera Module is a small PCB that connects to 

the CSI-2 camera port on the Raspberry Pi using a short 
ribbon cable. It provides connectivity for a camera 
capable of capturing still images or video recordings. 
The camera connects to the Image System Pipeline (ISP) 
in the Raspberry Pi's SoC, where the incoming camera 
data is processed and eventually converted to an image 
or video on the SD card (or other storage). You can read 
more about the Camera Module here: magpi.cc/28ljlsz. 


What model of camera does the Camera Module use? 
The Camera Module v2 uses a Sony IMX219 image sensor, 
while the original Camera Module has an Omnivision 5647. 
They are comparable to cameras used in smartphones. 


What resolutions are supported? 


and VGAg0 video modes, as well as still capture. The 
original Camera Module is capable of taking photos up 
to 5 megapixels and can record video at resolutions 
up to 1080p30. 


Which picture formats are supported? 

The Camera Module supports raw capturing (Bayer data 
direct from the sensor) or encoding as JPEG, PNG, GIF 
and BMP, uncompressed YUV, and uncompressed RGB 
photos. It can record video as H.264, baseline, main, and 
high-profile formats. 


How do I use the camera? 

There are three command-line applications provided 
for stills, video, and stills output uncompressed. These 
applications provide the typical features you might find 
on a compact camera, such as image size, compression 


The Camera Module v2 is capable of taking photos up 
to 8 megapixels (8MP). It supports 1080p30, 720p60, 


quality, exposure mode, and ISO. See the documentation 
for more details: magpi.cc/2r6ol1z. 


STORE AND MANAGE 
MULTIPLE PROJECTS 
IN ONE PLACE 


WD PIDRIVE FOUNDATION EDITION 
MADE FOR RASPBERRY PI 


Easily configure your WD PiDrive into safe workspaces 
with the included Project Spaces software and manage 
up to 5 projects from a single place. 


CHOOSE THE 
STORAGE THAT'S 
RIGHT FOR YOU: 


USB FLASH 64GB 


Includes microSD™ card 
with starter software 


$18.99 


USB HARD DRIVE 
250GB / 375GB 


Includes microSD™ card with starter 
software and WD PiDrive Cable 


Starts at $28.99 


Get yours at wdlabs.io/mp58b 


© wDLABS 


Western Digital, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation. 
microSD is a trademark of SD-3C, LLC. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies depending on operating environment. 
Product price and specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 


PROJECTS 


Í 


"OR DIGITAL MAKERS "'" 


ast month, Google and The starter project for the kit has 
The MagPi made history by you setup the Google Assistant SDK 
bundling a complete AIY to create a digital assistant. Push the 
Projects kit on our cover. button on the top of the Voice Kit, 
This kit is the first do-it-yourself ask your AIY Projects kit questions, 


artificial intelligence project to be and the Google Assistant wil e 

aunched by Google; more are in provide answers. 

development. With it, you can add We hope you had a lot of fu ; 
voice commands and responses building this starter project for using i 


o your projects. voice interactions, but it’s important 


not to stop there. There’s a lot you 


can do with this project beyond 


W | H G OOG LE he Google Assistant SDK. For the 


curious maker, we have some ideas 


w 


on how to hack AIY Projects, as well 


as how to use the Cloud Speech 
API as an alternative to the Google 
Assistant SDK. You can also set up 
Android Things as an OS. 


aiyprojects.withgoogle.com/voice In this feature, we re going to look 


at some of the things you can do 


with the AIY Projects voice kit. 
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SERVOS 


Servos can be connected to the 
Voice HAT board using standard 
JR connectors with three pins. A 
220 ohm resistor is built into the 
Servo rail. We use these pins to 
control an LED later in the tutorial 


DRIVERS 


ih 9. ETE RAS hw i G ) The Drivers rail is designed to 

; accommodate DC motors and 
relays. They are designed for high 
power and can handle inductive 
loads, 500 ms per pin 


PIN GUIDE 

Below the Servos and Drivers ANT TO BUY 4 
pins are guides to the function of AIY PROJ E CTS z 
each pin. The Servo pins are Pin, 


5V, and GND; the Drivers pins are 
Pin, +, and - 


Not everybody was lucky enough to get a free AIY 
Projects voice kit with The MagPi #57, and many readers 
, > have asked whether it is possible to purchase the kit 
separately. Sign up for our newsletter and we'll let you 
know when more AIY Projects Voice Kits are available. 
Head to our website and enter your email address. 


magpi.cc 
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IY Projects voice is a 
hackable project, so we 
encourage you to make this 


project your own. This guide gives 


you some creative extensions, 
settings, and even a different voice 


API to use. We 


10pe this project 


Sparks some new id 
First, though, yo 
from using the Goo 


eas for you. 
1 need to move 


gle Assistant 


SDK (the one thata 


nswers 


i ; > 


neral questions) to the Cloud 


Speech API. 


M >STEP-01 


Cloud Speech API 


One interesting project for makers 


is to create custom commands 
for the AIY Projects Voice HAT. 


These can do just about anything 


wi 


GE RENN AS Ze possible to add new actions and 


VO 


Assistant 
are available 


Cloud Speech API. This software 
Bre recognises your voice speech and 
Vie on ene) converts it into text. The Cloud 


th your Raspberry Pi. While it’s 


ice commands using the Google 
SDK, more options 
if you switch to the 


k i ag Pea Speech API supports 80 languages, 


extended audio 
| ability to add 
EA JE processing audi 
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clips, and the 
phrase hints for 


O. 


>STEP-02 
Turn on billing 
To use Google’s Cloud Speech 
API, you need to activate Billing 
— see page 28 of The MagPi #57 or 
magpi.cc/2q5SSF7. If you use it 
for less than 60 minutes a month, 
it's free. Beyond that, the cost is 
$0.006 for 15 seconds. Don’t worry: 
you ll ge if you 
your free limit. 

Open the web browser and click 


areminde go over 


on Google API Console link (or visit 
console.developers.google.com). 
In the API Manager window, click 
Enable API and search for Google 


Cloud Speech API. Click it and click 
E 


table in the top of the window (if 
it says ‘Disable’, then it is already 
enabled and you re ready to go). 


>STEP-3 
Credentials 
Choose Credentials in the sidebar. 


ials and 
tey. From 
nu, pick 
the name of your project (if you 
already have one) or select ‘New 
service account’. Enter a name so 
that you ll know this is 
voice recognizer stuff 


Click on Create Credent 
select Service Account 


the Service account me 


or your 
ike ‘Voice 


credentials’. Select ‘Project viewer’ 
as the role. 

Select JSON as the key type and 
click Create. 


>STEP-04 

Rename credentials 

The credentials file is downloaded 
automatically. The file name 
contains your project name and 
some numbers (like ‘aiyproject- 
c92d36fc7055.json’). Open a 
Terminal window and move it to 
your home folder, and rename it to 
cloud_speech.json: 


cd Downloads/ 


mv aiyproject-c92d36fc7055. 
json /home/pi/cloud_speech. 
json 


>STEP-05 
Check Cloud 
On your desktop, double-click the 
Check Cloud icon. Follow along 
with the script. If everything is 
working correctly, you ll see this 
message: ‘The cloud connection 
seems to be working.’ 

If you see an error message, 
try restarting your Raspberry Pi 
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with sudo reboot. Then follow Delete the # before It will read the response from 

the instructions above, or takea cloud-speech = true. Issac Asimov’s famous collection 

look at the instructions on the AIY of robot books. This a pre-built 

Projects page (magpi.cc/2q5SSF7). Now press CTRL+O, press ENTER, example speech. The response is 
and CTRL+X to save the file and not part of the Assistant SDK, but 

>STEP-06 exit Nano. a specific response (an action) 

Config file to a voice command. You can 

The application is configured by >STE P-08 create specific voice commands 

adjusting the properties found Start it up and actions. 

in /home/pi/.config/voice- Double-click the ‘Start dev 

recognizer.ini. This file lets you terminal’ icon and enter: >STEP-09 

configure the default activation Back up action.py 

trigger and choose which API to src/main.py You create new actions and link 

use for voice recognition. Don't them to new voice commands in 

worry if you mess it up: there's The Cloud Speech API will start. /home/pi/voice-recognizer-raspi/ hg 

a backup copy kept in /home/pi/ This API works like the Assistant src/action.py. We think it’s a good ‘ 

voice-recognizer-raspi/config. SDK, but instead of answering idea to back up this file before W 
general questions it responds to editing it. mi 

>STEP-07 specific commands. Say out loud: 

Adjust the config cd /home/pi/voice-recognizer- 

Open a Terminal window and enter “What are the three laws raspi/src/ 

the following: of robotics?” 


cp action.py action_backup.py 
nano /home/pi/.config/voice- 
recognizer 


VOICE HAT HARDWARE EXTENSIONS 


SPI_CLK (GPIO 11) SPI_MOSI (GPIO 09) SPI_MISO (GPIO 09) SPI_CEO (GPIO 08) SPI_CE1 (GPIO 07) 
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You can remove the 
kit's big arcade button 
and use the small red 
button on the board to 
activate the assistant 
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oogle Cloud Platform 


ow that you’ve switched 

from the Assistant SDK 

to the Cloud Speech API, 
you ll want to know what you 
can do with it. You add custom 
commands to the action.py file. 
There is a selection of example 
voice commands located right at 
the end of the code. These include 
the three laws of robotics that 
we used when testing the Cloud 
Speech API. 


You can edit the action. py file in 
Nano, but we think it’s better to 
use Python IDLE. Enter: 


xdg-open /home/pi/voice- 
recognizer-raspi/src/action. py 


Edit the actions file to create 
custom voice commands for AIY Projects 


This command opens the program 
in the Python IDLE window with the 
code marked up in colours, making 
it much easier to read. 

Scroll through and read the 
example functions. At the end, 
you'll see a section with: 


#Makers! Add your own voice 
commands here. 


Locate the function starting 
with def_add_commands_just_ 
for_cloud_speech(actor, say). 
This function contains the 
custom commands used in Cloud 
Speech API. 


We re going to add a simple 
keyword that creates a custom 
voice response. Scroll to the very 
end of the document and enter 
(with an indent): 


simple_command(_('meaning of 
life'),_('The answer to the great 
question of life, the universe, 
and everything is 42.')) 


Now start up the assistant. Double- 
click Start-dev terminal’ and enter: 


src/main. py 
Say: “What is the meaning of life?” 


Google Cloud Speech API will detect 
your keywords and read out the 
classic quote from Douglas Adams’s 
The Hitchhiker’s Guide to the Galaxy. 


Now that we can create actions, 

we re going to use the AIY Projects 
kit to control some hardware. Set up 
an LED circuit using a breadboard 

— follow the diagram shown on the 
next page. We are connecting the 
LED via the pins on Servo 0. Connect 
the live wire to Pin (on the left). This 
is GPIO 26 using the BCM numbering 
system. Connect the ground wire to 
GND (on the right). The middle pin 
provides a constant 5V of power. You 
can see the reference for each pin 
underneath the Servo 5 rail (check 
the diagram in ‘Voice HAT hardware 
extensions’ on p69 for reference). 
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We have found that it will work 
by connecting wires directly to the 
through-holes on the board. For 
amore reliable circuit, however, 
solder the pins supplied with your 
Voice HAT. 


We need to open and edit the 
action.py file again. Enter this 
command in a Terminal window: 


xdg-open /home/pi/voice- 
recognizer-raspi/src/action. py 


Scroll down and look for 
this comment: 


# Makers! Implement your 
own actions here. 


Add the code from own_actions.py 
(page 73) underneath the comment. 
pberrypiorg//magpi — 
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..... 
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Then add the code from voice_ 
commands.py (page 73) to ~/voice- 
recognizer-raspi/src/action.py 
below the comment ‘Add your 

own voice commands here’. Make 
sure it indents with the comment, 
like this: 


# Makers! Add your own 
voice commands here. 


actor.add_keyword(' light 
on', GpioWrite(26, True)) 


In voice_commands.py we’ve 
created actors for both “light 

on” and “lights on”. We find this 
makes recognition more reliable. 
Add the rest of the code, then select 
File > Save and exit IDLE. 


Double-click ‘Start dev terminal’ 
and start up the assistant: 


src/main.py 


Now say “light on” slowly and 
clearly. If everything is connected 
correctly, your LED will light up. 
Say “light off”, and it will turn off 
again. You can also use variants 
such as “hey, light on” and “turn 
the lights on”. 
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Use code to control 
GPIO pins via your 
assistant. This short 


program turns an LED 


light on or off 


PROJECTS 


$ s « how 


-* june 2017 Mägi A 


it 


FOR MAK 


7 7 TS tree 
3 DSS Brea nae 
£/ ra 


’ ne of the key things with >STEP-01 GNU Chess is played from the 
You ll Need ATY Projects is that it Commands command line, although often 
: a 


ows you to add human You can issue Terminal commands it will be used with a graphical 
- AIY Projects voice interaction to your projects. via Cloud Speech API. Let’s test interface such as XBoard. But we’re 
voice kit So you can move beyond using this out by adding a handy function going to use AIY Projects to enter 
buttons (real or virtual) and mouse to the AIY Projects voice kit: the the moves in the command line. 
* GNU Chess clicks. With the Cloud Speech ability to shut down and restart the 
an Dray API, you can talk directly to your kit with a voice command. >STEP-03 
a NA DE AEN ' í Raspberry Pi, and have a natura In shutdown.py (page 73) there AIY chess 
7 25 conversation with your devices. are two actor.add_keyword() Now add the code from 
: The hope is that in the near unctions. These contain 'shut aiy_chess.py (page 73) to the 
future, you Il be able to walk up to down’ and ‘restart’ as the command  action.py file (in home/pi/ 
a device and say “what are you?” words. Enter the code from voice-recognizer-raspi/src/ 
and “how do I use you?” and havea  shutdown.pyintoaction.py, as you  action.py). This code adds 
conversation with it. did with voice_commands.py. interaction with GNU Chess to 
We are delighted to find Start up the assistant (enter src/ your Cloud Speech API. Enter 
The MagPi readers already main. py in ‘Start dev terminal’). the code and start the assistant. 
Wise piles creating code for ATY Projects Now when you use Cloud Speech Double-click ‘Start dev terminal’ 
AM : Zł ; that interacts with devices, such API, you can press the button and and enter: 
; i as this program by reader Mike say “shut down”. The AIY Projects 
Y PRIE T Redrobe (magpi.cc/2q8NW20). It kit will run the shutdown scripts and  src/main.py 
De hacks together AIY Projects with power off safely. Say “restart” to 
ow ee : : GNU Chess and is an excellent restart your AIY Projects kit. Now press the button on your AIY 
20/4 example of building an interface Projects voice kit to make a move. 
that controls a program. >STEP-02 


Quick Tip Install GNU Chess >STEP-04 


SOURCE CODE We are going to take this idea of Playing chess 

command-line interaction to greater You say “chess D2 D4” to play 
If you're using the SD card image provided by AV Projects lengths by setting up the Cloud a move. You will see a small 
the source for the voice-recognizer app is already Speech API to work with GNU Chess chessboard displayed in text on 
installed on your device. You can browse the Python for a command line-based chess the AIY Projects screen. The AIY 
source code at /home/pi/voice-recognizer-raspi/. game. The first step is to install Projects kit will then speak the 
Alternatively, the project source is available on GitHub: GNU Chess on your Raspberry Pi. computer opponent’s move (and 
magpi.cc/2pH04KQ. Browsing code such as main.py and show on me text chessboard). 
action.py is the best way to get a feel for what the code is sudo apt-get update You can also be lazy and say “chess 


D4” if there is only one piece that 
sudo apt-get install gnuchess could move to D4. 


capable of doing. 
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# SRS SS SS SS SS SSS SSS 
# Makers! Implement your own actions here 
# FRR SSS SSS ZZ SSS SSS SSS SSS SSS SSS 
p = None 


class playChess(object): 


def _ init__(self, say, keyword): 
self.say = say 
self.keyword = keyword 


actor.add_keyword('light on', GpioWrite(26, True)) 
actor.add_keyword('lights on', GpioWrite(26, True)) 


actor.add_keyword('light off', GpioWrite(26, False) ) 
actor.add_keyword('lights off', GpioWrite(26, False) ) 


def run(self, voice_command): 
move = voice_command.replace(self.keyword, '', 1) 
global p 


if (p == None): 
p = subprocess.Popen(["/usr/games/gnuchess"," 


-g'],stdin=subprocess.PIPE,stdout=subprocess.PIPE) 


p.stdin.write(bytes(move.lower() + 'ln', 'utf-8')) 
p.stdin.flush() 

response = "" 

if all(x.isalpha() or x.isspace() for x in move): 


# no numbers (d2d4) so its a command like new, undo, remove 


response = p.stdout.readline().decode("utf-8") 
response = “ok,” + move 

else: 
self.say("ok, you played," + move) 


while ("move" not in response): 
response = p.stdout.readline().decode("utf-8") 
logging. info("Chess log: %s", response) 


logging.info( Chess: %s", response) 
self.say(response) 


import RPi.GPIO as GPIO 


class GpioWrite(object): 
'''Write the given value 
to the given GPIO.''' 


def _ init__(self, gpio, value): 
GPIO.setmode(GPIO.BCM) 
GPIO.setup(gpio, GPIO.OUT) 
self.gpio = gpio 
self.value = value 


def run(self, command): 
GPIO.output(self.gpio, self.value) 


SOLDER YOUR PINS 


The Voice HAT works more reliably with the pins 
soldered in the holes. A strip of pins will have been 
supplied with your AIY Projects kit. 

If you want a rough guide to soldering, here is a very 
handy instructional comic (PDF): magpi.cc/2pUoMIr. 
It's an excellent visual reference and a cool thing to put 
on the wall. Be careful using the board with soldered 
pins, as it's easy to get a 5V shock by touching the 
positive and negative pins. Power down the kit before 
connecting and disconnecting wires. 


actor.add_keyword(_('shut down'), SpeakShellCommandOutput(say, "sudo shutdown -h now", (‘Shutdown failed'))) 
actor.add_keyword(_('reboot'), SpeakShellCommandOutput(say, “sudo shutdown -r now", (‘Reboot failed'))) 
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FROM THE MAKER 


raspberrypi.org/magpi 


£12.99 


200 pages of 


RASPBERRY PI 


PROJECTS BOOK 


VOLUME 2 


Amazing hacking and making projects 
from the creators of MagPi magazine 
Inside: 

How to get started with Raspberry Pi 
The most inspirational community projects 
Essential tutorials, guides, and ideas 


Expert reviews and buying advice 


Available 
mE magpi.cc/MagPiStore 


plus all good newsagents and: 


WH Smith BARNES&NOBLE 


)> Google Play a Amazon 
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4 Available on the 
a App Store 


Maker 
says 
Pocket- 
sized fun is 
the name of 
this game - 
our most fun 


Bonnet ever! 
Adafruit 


JOY BONNET 


JOY BONNET 


PICADE 
CONSOLE 


The control unit 
from the Picade 
arcade cabinet, 
it can be fitted 
with a Pi 3, 
plugs into a TV, 
and features a 
robust full-size 
arcade joystick 
and buttons. 


£90 / $120 
magpi.cc/2pwjhhs 
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ver since its arrival, 

the tiny Pi Zero has 

been used for mini 
retro gaming projects, usually 
involving inserting one inside 
an old joypad. Adafruit's Joy 
Bonnet offers a much simpler, 
quicker route to pocket-sized 
retro gaming, however. Coming 
fully assembled, it simply stacks 
on top of your Raspberry Pi Zero. 
Naturally, you'll need to solder 
(or hammer) a GPIO header to 
the latter first. A couple of plastic 
spacers and screws keep the 
Bonnet firmly in place — which 
is pretty essential as you’ ll be 
pressing its buttons continuously 
and therefore pushing it down 
on the Pi. While it’s comfortable 
enough to hold in your hand, you 
may want to add the bottom of 
a Pi Zero case for extra comfort 
— although we had problems 
keeping the mini-HDMI display 


adapter fully inserted through 
the hole in an official case. 

You’re then ready to install 
a retro gaming OS. Adafruit 
recommends using RetroPie 
(retropie.org.uk) or Emulation 
Station (emulationstation.org) 
— just flash your microSD card as 
usual. With wireless set up, you 
can then SSH in and use a single 
command to install the Joy Bonnet 
Python library and software. It 
takes a little while and offers 
options to disable overscan (to 
remove the black border on some 
monitors) and install a gpio-halt 
utility for safe shutdown. 

Upon rebooting, the OS (we 
used RetroPie) should sense the 
Joy Bonnet. We were somewhat 
surprised to see it recognised as 
a keyboard: it turns out that the 
Bonnet's buttons emulate keys 
such as Z, X, and ENTER. Another 
interesting point to note is that the 


Mount a joypad on your Pi Zero to get retro gaming 


mini joystick is actually analogue, 
although its directions produce 
cursor key presses — more on this 
later. Once you have assigned 

the various buttons and joystick 
directions to functions in RetroPie, 
you re ready to play — naturally, 
you'll need to have added a few 
game ROMs in the relevant system 
folders in RetroPie to make them 
appear in the on-screen menus. 


Tiny buttons 

We started off with a quick 

game of Galaga 88 running on 
the MAME arcade emulator. 
Everything worked fine and 

the controls were responsive 
enough. Upon switching to Street 
Fighter II on SNES, however, we 
encountered a slight drawback. In 
place of L and R shoulder buttons, 
the Joy Bonnet has a couple of 
tiny buttons labelled 1 and 2, 
located in the middle of the top 
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ELECT = 
adatruit 


of the board — so not that easy to 
reach in the heat of battle. The 
four main buttons (X, Y, A, and B) 
worked well, although they're far 
smaller than the ones on original 


a fix. As mentioned previously, 
the mini joystick is analogue but 
emulates digital presses, and we 
found it extremely difficult to 
obtain diagonal directions for our 


Joy Bonnet offers a much 
simpler, quicker route to 
pocket-sized retro gaming 


joypads, so not that comfortable. 
While not quite so critical, the 
Select and Start buttons are the 
same small size. 

Next, we thought we’d have 
a blast with classic vertically 
scrolling shmup, 1942. Here we 
came across a bugbear that spoilt 
our enjoyment until we figured out 


plane in the game. Fortunately, 
we managed to sort this out by 
editing the Joy Bonnet’s Python 
library and reducing the positive 
and negative thresholds for the 
analogue stick. Setting these at 
-300 and 300, rather than the 
original -600 and 600, we found 
the stick considerably more 
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sensitive and were therefore able 
to obtain the diagonal directions. 
It’s also possible to edit the key 
presses produced by the buttons 
in this file, which might come in 
useful when playing a Spectrum 
or C64 game with unorthodox 
keyboard controls. 

Note that the Pi Zero is not 
capable of emulating more 
powerful consoles such as the 
N64 and PlayStation. You could 
always use the Joy Bonnet with 
a Raspberry Pi 3, although it 
wouldn’t exactly be handheld. 


Not as comfortable to hold or 
responsive as a regular game 
console joypad, the Joy Bonnet 
is unlikely to net you many 

high scores. Still, it is a cute 
concept that makes it easy to 
quickly get retro gaming on a Pi 
Zero: a neat portable solution 


that you can carry around with 
you to plug into any TV. You 
might want to invest in a longer 
HDMI cable so you don't have 
to stand quite so close to the 
screen, though. 


k*k* 
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WD PIDRIVE NODE ZERO 


WD PIDRIVE 
NODE ZERO 


A custom low-energy hard drive coupled with a Pi Zero 


he WD PiDrive Node 
Zero is a clever all-in- 
one unit that combines a 


WD PiDrive with a Raspberry Pi 


WD PIDRIVE 
FOUNDATION 
EDITION, 
USB FLASH 


An SD card 

and USB drive 
combo that you 
connect to a 
Raspberry Pi. It 
has less storage 
than the PiDrive 
NodeZero, 

but itis a 
smaller solution. 


£20 / $18.99 
magpi.cc/2pJjBpT 
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Zero board. 

The PiDrive is WD’s low-energy 
hard drive, designed specifically 
for the Raspberry Pi. It replaces 
the regular SATA III port with 
a micro-USB connection. 

What we have here is a PiDrive 
in a plastic caddy with a mounted 
Pi Zero board. The PiDrive Node 
Zero caddy provides two additional 
full-sized USB ports, making 
it easier to hook up a keyboard 
without requiring a mini-USB 


ADE- Own Il) £- STM KD. 


4510929 "1906879 9619665 '9G0BLIS “HOO RG SO) = 


Pow 10 pannel N 14082 30 (ORL "BOR jA PIOA Oq YA Kiveazem OPOŁĄ 


adapter, but you still need a mini- 
HDMI to HDMI adapter. 

The PiDrive is a custom- 
engineered WD hard drive that 
is more power efficient than 
a standard storage drive. 

Included is a 4GB micro SD card 
preloaded with a custom version of 
NOOBS. When you first power on 
the PiDrive Node Zero, you install 
Raspbian onto the primary hard 
drive. The SD card boots the device, 
but you run it from the hard drive 
(so you don’t need to juggle the 
two drives). 

You can perhaps think of it as a 
super-smart hard drive with built-in 
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computing functionality, or you could 
regard it as a Pi Zero with super-sized 
storage space. Either way, it’s an 
intriguing all-in-one unit that gets 
you thinking about usage. 

WD suggests that it’s “ideal 
for video recording, data 
logging, offline analytics, and 
applications where stand-alone 
operations are needed because of 
network limitations or privacy/ 
security restrictions.” 

There’s some merit to all of 
these applications, but getting 
the PiDrive Node Zero on to 
a network opens up a much 
broader range of potential uses. 


Benchmarking 

The WD PiDrive Node isn’t as 

fast as WD’s USB flash drive 
offering (see ‘Related’). We dida 
buffered test with the hdparm tool: 
hdparm -t /dev/sda. We ran the 
test three times and got an average 
of 28.15 MB/sec. 

Next, we ran a timed cached test 
using hdparm -T /dev/sda. Our 
average speed was 245.37 MB/sec. 
Neither speed will set the world 
alight, but we’re not sure this is 
problematic. Most of our imagined 
uses for the drive are as nodes on 
a system, set up to perform a task 
and tick away at it. 
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WD PIDRIVE NODE ZERO 


A compact, 
all-in-one unit 
that includes 


a WD PiDrive 
Western Digital 


Networking Once on a network, the Node 

The Pi Zero lacks built-in wireless Zero is ideal for DIY projects like a 

networking, unlike the newer mini-DLNA and Samba file server, 

Pi Zero W. mobile backup device, a media 
You have a few options fortaking device, or music box. There are 

a PiDrive Node Zero online. Add reports of folks using it to create 

a USB-to-Ethernet adapter for Bitcoin nodes. 


A super-smart hard | |": A mi 
drive with built-in Sa ee 
computing functionality 


hook-up to a wired network, or use In fact, it’s ideal for any task that 

a USB wireless networking dongle requires a little processing power, 

for access to WiFi. with minimal energy draw and a A neat, all-in-one unit that 
It is physically possible to decent amount of storage. There’s combines Pi Zero computing 

remove the Pi Zero from the nothing here that you couldn't with hard drive storage. 

caddy (using a Torx screwdriver) hack together with Pi Zero, a few We'd rather it packed the 

and slot in a Pi Zero W. adapters and an external hard drive, newer Pi Zero W, but it 

You'll need to download the but the self-contained unit makes remains a charming and 

latest version of the PiDrive it ideal for setting up and tucking it handy piece of kit. 

Foundation software (currently away in your house somewhere. WD 

in beta) from the WD Labs also sells a Node Zero Enclosure for * * * * 

website: magpi.cc/2ns5InA. £8 that turns it into a neater unit. 
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TOUCH PHAT 


© a EET 
.................... 


TOUCH PHAT# 


simple interfaces. 
says re tea owe] 
Six touch- ® http://pimoroni.com 
sensitive 
buttons 
to use for PHAT -Q: 
HTTP.//PIMORONLCOM 
whatever 
your heart 
desires 
Pimoroni 
An easy way to add button inputs to your projects 
eed to add some button keep the pHAT rock steady on top and will stay triggered/lit until 
controls to a projectyou re of the Pi as you press the buttons. released; you can press as many 
making? Pimoroni’s Alternatively, you could combine as you like simultaneously, 
Touch pHAT makes it easy. This Pi it with Pimoroni's neat-looking too. They can even be activated 
Zero-sized board boasts six touch-  Pibow Zero W case. through a thin transparent 
sensitive buttons which light up Like most Pimoroni add-ons, layer if needed. Note that if you 
when pressed; white LEDs located the Touch pHAT has its own wanted to attach alligator clips 
l i , d on the underside produce a yellow/ Python library, which is easily to the buttons to attach remote 
R green glow through the translucent installed — along with any missing triggers (such as pieces of fruit), 
board sections. While the buttons dependencies — using a single you'd have to scrape down to the 
RAINBOW are marked A, B, C, D, Back, and Terminal command. A couple of copper on each button to make the 
HAT Enter (and referred to as such when examples are supplied: a simple connection work. 


Compatible with coding), each has a large white area button-press demo and a GUI app 


Sa for custom labelling with a sticker launcher. The code syntax is simple Jast word 
this full-size or dry-wipe marker. enough, using on_press and 
HAT features The pHAT is supplied with a on_release events to register the The Touch pHAT makes it a lot 
A female header which you'll need relevant touch actions. It's then easier to add input buttons 
Epy. to solder in place. While the board completely up to you as to what to projects, instead of having 
LEDs, buzzer, has a Pi Zero form factor, itcanbe these will trigger. Possible uses to wire up push-buttons 
and PE used with any 40-pin Pi model. for the Touch pHAT include as a individually. What you use it 
dy, Equipped with a CAP1166 capacitive control panel for a robot, a remote for is completely up to you, but 
touch and LED driver chip, it control for home automation, a the touch-sensitive buttons 
4 uses PC for communication, and drum machine / mini piano, and are really TeSponSIvVe and the 
therefore requires only two GPIO a simon game. Bohr Up effectis anice bonus: 
r pins. No standoffs are supplied, Most importantly, the buttons 
magpi.cc/2IX1r6h . 
but you may want to add some to are very responsive to touch 
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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 


We're always looking for people with coding skills to volunteer to run 
a club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you'll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 


So to find out more, join us at www.codeclub.org.uk 


BUILDING A 2D Given this, anyone should be 


able to start working through the 


GAME PHYSICS code, gaining an understanding 


of JavaScript along the way. 
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Eliminate bottlenecks, adopt best 
practices, and automate to avoid 


ENGINE 


Authors: Michael Tanaya 
Huaming Chen, 
Jebediah Pavleas, 


The authors recommend 
NetBeans, but if you have 
your own favourite code 
editor, you ll probably be 
able to ignore IDE-specific 


Fe dmi k & Kelvin Sung } s 
repetitive admin tasks Publishes Apress instructions and get on with it, 
Price: £14.99 implementing the core of the 


WICKED COOL SHELL SCRI 


Authors: Dave Taylor 

& Brandon Perry 
Publisher: No Starch 
Price: £27.99 
ISBN: 978-1593276027 
magpi.cc/2pGuakl 


Cookbook-format collection of 
Bash scripts, with brief tutorial 
intro, good explanations of 
how the scripts work, and great 
suggestions for modifying 
them. As useful on your 
Raspberry Pi as on your server. 


THE PRACTICE OF SYSTEM AND 
NETWORK ADMINISTRATION 


Authors: Thomas A Limoncelli, 
Christina J Hogan 
& Strata R Chalup 
Publisher: Addison Wesley 
Price: £51.99 
ISBN: 978-0321919168 
magpi.cc/2pGtQeo 


From section one, ‘Game- 
Changing Strategies’, this 
book gets harried sysadmins 
back on track with best 
practices and practical tips. 
Thoroughly updated, with 
good DevOps coverage 

- even for organisations 
without developers. 


Author: Chris Sanders 
Publisher: No Starch 
Price: £39.99 

ISBN: 978-1593278021 
magpi.cc/2pGxFAs 


PRACTICAL PACKET ANALYSIS 


Wireshark doesn't just let you 
peer inside data packets and 
find malware, it offers valuable 
clues about bottleneck and 
connectivity issues in your 
network. Sanders takes a 
practical approach to getting 


and then using this information. 
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ISBN: 978-1484225820 
magpi.cc/2po50sF 


This is a short, narrowly focused 
book, designed to take the reader 
through the process of building 
a 2D physics engine, specifically 
in JavaScript, working with rigid 
bodies, for use in HTML 5 games. 
All it asks of the reader is a basic 
understanding of object-oriented 
programming (OOP), from any 
language, and some familiarity 
with basic data structures such 
as linked lists and dictionaries, 
plus some basics from high 
school maths. 


CORE JAVA: 


VOLUME II 


Author: Cay S Horstmann | 
Publisher: Prentice Hall | JAVA 
Price: £36.99 | 

ISBN: 978-0134177298 

magpi.cc/ 2r5Gbtl | 


A thousand pages of 
Java isn’t everyone’s 
idea of fun, but if you’ve 
mastered the basics and want to go 
further, there are few better guides 
than Dr Horstmann. It’s not full of 
quirky cartoons, nor zoo animals 
but, as with Volume I (ISBN 978- 
0134177304) - which was updated 
a year earlier, and is an excellent 
start in Java for programmers 
with some OOP experience in 
C++, Python, or elsewhere — it 
concentrates on directly using code 
to illustrate language features. 
Topic selection and order is well 
judged, with the stream library 
filling the opening chapter, then 


| Yolu 
| Ae Advanced Features, 


physics engine in your first hour 
or so after opening the book. 
The heart of the book concerns 
several aspects of the physics 
and implementation of collision 
detection, and not only will this 
get you to some working code, but 
should give you enough to take away 
and try in other languages, without 
being propped up by libraries. The 
final demo project, and pointers to 
further exploration, should see you 
ready to build your own games. 


Score 


after I/O, XML, networking, and 
the latest on JDBC and database 
programming in Java, two whole 
chapters for the new data and time 
—— API, which is a much 
needed improvement in 
Java. Internationalisation 
gets a thorough treatment, 
with a completely worked 
example, followed by 
advanced Swing, native 


ag methods, and other 


useful topics. 

Despite the serious approach, 
Horstmann s subtle dry humour 
does peek through, and this 
well-written tutorial covers the 
important advanced features in 
Java SE (Standard Edition) 8 and 
— given the time most Java-using 
businesses will take to move over to 
Java 9, when it eventually appears 
— it will also serve as a reference for 
some years to come. 


Score 
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PROJECTS 
MADE EASY 


Authors: Carol Vorderman 


Caro! Vorderman 


game. It’s all well done, and uses 
Scratch’s strength to give the 
quickest introduction not just to 
some programming concepts, 

such as loops, but to the reward of 
achieving something on 
the screen. 


© Sway Giahifiam Me pam Sound, with Sonic Pi, 
Publisher: DK Children M Ha Cts follows, then generating 
Price: £3.99 crazy patterns with 


ISBN: 978-0241282847 
magpi.cc/ 2r5B8ti 


Dorling Kindersley’s 
colourful and well- 
laid-out education 
books provide great introductory 
materials on programming 

the Raspberry Pi for younger 
children. The initial setup 
material is similar to what you'll 
find elsewhere, but looks far 
less intimidating in friendly, 
cartoon format. 

Once set up, the first task is 
Scratch: drawing a sprite, giving 
it movement, in response to the 
keyboard, and making a course 
— in this case for a jailbreak 


PROFESSIONAL 


GIT 


Author: Brent Laster 
Publisher: Wrox 
Price: £42.50 

ISBN: 978-1119284970 
magpi.cc/2r5BWhN 


Professional 


This is a deep and 

immersive guide to Git, with 
plenty to teach those who’ve been 
using it for a while, yet goes out of 
its way to be welcoming to new Git 
users coming from other version 
control systems. The first three 
(shortish) chapters introduce the 
concepts of Git before installation 
is introduced. You can skip ahead, 
but it's worth reading through 

for Laster’s clear explanations of 
key concepts, and the promotion 
model (Git’s levels) as, if you’ve 
picked up Git by diving in and 
using, you may have missed a 

full understanding. 
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Python. Again, well 
chosen to get younger 
learners producing real 
results. Challenges at 
K.k the end of each project 
help push the learner to 
build on what she has 
learned, with help for each at the 
end of the book. Lighting up an art 
project with LEDs rounds off a very 
useful introduction that will make a 
great gift for a child less likely to be 
enthused by a larger tutorial book — 
and it's also less likely to scare off 
reluctant parents from helping. 


Score 


Impatient readers of the 
subsequent setting up chapters 
may feel some things are 
explained in too much 
depth, but again this is 
driven by the need to instil 
clearer understanding 
as a foundation for later 
sections. In particular, 
sections headed Advanced 
Topics in some chapters are 
full of useful information. 

A dozen connected lab sections 
filled with practical exercises help 
the reader do the real work of using 
practice to embed the theoretical 
knowledge, and cover everything 
from working with GitHub, to 
subtrees. With initial weighting 
towards working locally, everything 
gets a timely introduction, and 
this is one book that will carry the 
novice through towards expert 
level. Recommended. 


Score 


BOOKS 


ESSENTIAL READING: 
DATA SCIENCE 


As data expands, the world needs more 
data scientists - start learning today! 


Python Data Science Handbook 


Author: Jake VanderPlas 
Publisher: O'Reilly 
Price: £47.99 

ISBN: 978-1491912058 
magpi.cc/ 2r5wTxT 


The best data science reference 

and tutorial for Python programmers, 
covering IPython, NumPy, Pandas, 
Matplotlib, and Scikit-Learn. 


Digital Signal Processing 
with Python Programming 
Author: Maurice Charbit 

Publisher: Wiley 

Price: £96.50 

ISBN: 978-1786301260 

magpi.cc/ 2r5WhDY 


Digital Signal Processing 


with Python Prograr 


Data science needs probability theory, 
statistical inferences, hidden Markov 
models (HMM), and Monte Carlo 
methods - learn them with Python. 


R for Data Science 


Authors: Garrett Grolemund 
& Hadley Wickham 

Publisher: O'Reilly 

Price: £31.99 

ISBN: 978-1491910399 

magpi.cc/2r5C158 


Fairly beginner-friendly introduction 
to all things data and R - the “other” 
language of data science. 


Data Visualisation 


Author: Andy Kirk 
Publisher: Sage 

Price: £31.99 

ISBN: 978-1473912144 
visualisingdata.com/book 


With presentation and interpretation 
of data central to so much today, 
this guide is essential reading for 
almost everyone! 


Advanced Graph Theory 
and Combinatorics 


Author: Michel Rigo 
Publisher: Wiley 
Price: £116.00 

ISBN: 978-1848216167 
magpi.cc/2r5YJue 


advanced Graph Theory 
and Combinatorics 


More advanced mathematics for ML 
and big data, culminating in applying 
Perron-Frobenius theory to explore 
Google Page Rank. 
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THE MONTH IN 


t’s always our pleasure to release surprise 

special issues that the whole community 

loves. We’ve seen a lot of you excitedly show 
us your AIY Projects kits, boxes, and projects since 
the issue came out, which has been great! Here are 
some of our favourites. 


PROJECTS 


Issue 57 went down well with the community 


Bastiaan Slee has 
given a second life 
to these Nabaztag 

loT devices by 
supercharging 
them with some 
Raspberry Pi magic. 
Find out how here: 
magpi.cc/2qiCrxwW 


Tom Archer has been very busy with his AIY Projects 
kit. He 3D-printed this wonderful custom case 
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Lorraine Underwood's picture frame lets her mother in Ireland send audio messages 
to her grandchildren and vice versa. It's a bit like the portraits in Thunderbirds 


building their kits, but this one from Andy Grimley caught our 
eye, as it seems to be floating. We didn’t know it could do that! 


j> We got plenty of pictures from people who have finished 


< 


Tom Archer added 
Google Music 
integration to his 
custom box. It even 
scrolls the song title 
on the LED board on 
the front. Amazing! 
Here's the video: 
magpi.cc/2rh4dRP 


This project by CJ Watkins keeps an eye on the sky, 
tracking aircraft, and sings to you while it does it 


AIY VOICE KIT 
MAILING LIST 
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Domhnall O'Hanlon sent us this simple yet lovely video of him using 
his AIY box in the Irish National Botanic Gardens magpi.cc/2rgKjqb 
Tobie Salyers’ Robie Junior is being upgraded with an AIY kit inside. 
So far it can talk, but controlling the eyes is the next part of the project 
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THIS TIME IT S 


OUTDOORS 


Pioneers is back with a brand new challenge, and this one asks you to go outside 
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GETTING STARTED 

WITH WEARABLES 

One of the suggestions for the 
latest Pioneers challenge is a Pi- 
powered coat. This tutorial will 
show you how to create a wearable 
project with lights and more, using 
a Raspberry Pi. Perhaps you can use 
what you've learnt here to create a 
magic hat with sounds and lights? 
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he first Pioneers challenge was excellent. 
The task was to make the judges laugh, and 
you managed that very well. Now comes the 


second challenge, and this time the Pioneers team 
want you to ‘Make it outdoors’. 

What does this mean? Well, the idea is that you 
make something that can work outdoors. Whether 
you’re making a little time-lapse spy camera fora 


bird box or an umbrella that tells you the wind speed 


POO NEAR YOU 


The excellently named ‘Poo near you" 


teaches you how to plot data onto a 
Google Map, in this case using the 
poo emoji as a marker. This could 
probably be used for more useful 
tasks, like using it to check stocks of 
Switch consoles in local game shops 
so you can try to hunt them down 
when you're in town. 


and temperature, as long as it’s used outside your 
house, it’s eligible for entry. 

Find out more about the new Pioneers challenge 
and how you can get yourself involved, take a look 
at the Pioneers website: magpi.cc/2iHKIP5. 


RASPBERRY PI ZERO 
TIME-LAPSE CAMERA 
Another wearable tutorial, 
although this one teaches you 
how to make a wearable glasses 
camera to create a time-lapse 
video of your day. Combine this 
with the wearables starter guide 
to make ridiculous costumes and 
cartoon-style inventions. 
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KICKSTART THIS! 


Raspberry Pi projects you can crowdfund this month 


"am 


PIPLAY PORTABLE 


It looks a bit similar to the Joy Bonnet, which we've 
reviewed in this issue. This one is a bit more DIY, 
though, and slightly larger as well, which may improve 
the ergonomics of the device. It runs on AA batteries 
and allows you to use headphones. It's still a little way 
off its target so if the Joy Bonnet isn't for you and you 
want a nice DIY project, take a look at PiPlay instead! 


COMMODORE 64C 
RASPBERRY PI 
CONVERSION FRAME 


There’s still a lot of love for the Commodore 64, even 

so many years on. Re-releases with more power in the 
same box always seem popular, and this conversion kit 
allows you to add new life to older models — specifically 
the Commodore 64C. It’s also advertised as ‘non- 
destructive’, allowing you to mount a Raspberry Pi 2 or 3 
inside without having to break your C64. 
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oming in kit form, the 

POCO Zero is a tiny 

handheld device with a 
2.8-inch touchscreen, powered by 
a Raspberry Pi Zero W. Its creator, 
Grant Sinclair, tells us that the 
roots of the POCO project stretch 
back to around 2009, when he saw 
the huge success of the Flip Video 
camera. “I wanted to make a credit 
card-sized version with much 
higher-spec components. I spent 
a couple of years developing it.” 
Disaster struck when the chip he 
was planning to use went end-of- 
ife, but Grant re-engineered the 
product to use the newly released 
Raspberry Pi. He says he got a lot 
of inspiration from his family: 
his uncle Sir Clive is famous for 
aunching iconic 1980s computers 
such as the Sinclair ZX80, ZX81, 
and Spectrum. “I got working with 
my family business quite young.” 

Designed back in 2010, the 

original POCO prototype was a 


POCO 


ZERO POCKET COMPUTER KIT 


GRANT SINCLAIR com 


very different product, with a 
considerably higher spec and price 
point. “It used a lot of very clever 
stuff. The body was made out of 
magnesium, a very thin-wall casing. 
Pretty much all the technology in it 
was pushing the boundaries of what 
you could do. It was one of the first 
products to use an AMOLED screen.” 
It was also set to feature a high- 

end camera module specially made 
by Panasonic. 


From zero to Zero 
Following supply problems 

with the chip and screen, Grant 
redesigned the POCO to use the 
Raspberry Pi and a custom screen. 
Marketed mainly as a portable 
camera, it sadly failed to meet its 
Indiegogo crowdfunding target in 
2015, so Grant went back to the 
drawing board again. Luckily, the 
Pi Zero had just been launched, 
which offered the ideal solution 
for a handheld device. The result 


a kit computer_ 
| gaming console . 


« music player 
8MP HD camera* 


is the POCO Zero, a mini computer 
kit that requires the maker to cram 
a lot of components into a small 
space, including a tiny speaker, 
amplifier, transformer, and 
rechargeable LiPo battery. 
“It’s not your average maker 
kit,” explains Grant. “I wanted 
to do it so it presented a bit of 
a challenge putting it together. 
So it’s like a pro maker product 
really. At the end of it, you have a 
proper consumer-grade product.” 
Although Grant says it’s “packed 
to the max” inside the case, there 
is a little space left for modding: 
“You can get wires in very easily.” 
While Grant says it'll take the 
average maker “a good day’s 
work” to assemble the POCO Zero, 
soldering is minimal. “Cramming 
it all inside is a bit fiddly, but 
it’s no harder than assembling a 
remote control car.” To help users 
out, video instructions will be 
made available online. 
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As wellas a 2.8-inch 
touchscreen, there's an HDMI 
socket to connect to a TV 


The twin joysticks can be 
pushed in to function as Start 
and Select buttons 


POCO PI POWER 


Multiple uses 

Grant confirms that the POCO 
Zero’s primary use will be 

for retro gaming, running 
EmulationStation or RetroPie, 
and that scripts will be provided 
to set up the controls for its 
buttons and twin joysticks. While 
the Pi Zero isn’t quite powerful 
enough to handle emulation of 
PlayStation or Nintendo 64 games, 
it can manage most other retro 
systems — including, of course, 
the Sinclair Spectrum. 

The POCO Zero can also be used 
as a camera, music player or, by 
connecting it to a TV or monitor, a 
fully functioning computer. While 
some basic user guides will be 
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provided, Grant says: “I wanted 

to keep it as simple as possible so 
if you want to turn it into a [WiFi] 
mobile phone, that’s doable as 
well... I want people to discover 
their own stuff: I don’t want to tell 
them what to do too much.” 

Asked how many he’s hoping to 
sell, Grant responds: “I don’t really 
look at a product unless I think it’s 
got the potential to sell a million 
units.” He also tells us that two 
additional versions will be made 
available: one ready-assembled 
and another omitting the camera. 
As for future Pi-based products, 
Grant reveals he is working on an 
idea for a tablet device with “a very 
innovative angle to it.” 


— zg 


POCO ZERO 


A mini-USB hub provides three ports, 
including one for charging the LiPo battery 


Hami 


5.6mm 


The self-build kit is a challenging project, taking the 
average maker about a day to assemble, but the result 
is a gorgeous consumer-grade gadget 
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Lucy graduated from the 

Singularity University Graduate 
Studies Program in 2011, focusing on 
how robotics, nanotech, medicine, 
and various technologies can tackle 
the challenges facing the world 


IBM Watson Education 


From a doctorate in bubbles to building robotic 
dinosaurs and judging the BBC’s Robot Wars: 
is there anything Dr Lucy Rogers can’t do? 


r Lucy Rogers calls 

herself a Transformer. 

“T transform simple 
electronics into cool gadgets, 
I transform science into plain 
English, I transform problems into 
opportunities. I am also a catalyst. 
I am interested in everything 
around me, and can often see ways 
of putting two ideas from very 
different fields together into one 
package. If I cannot do this myself, 
connect the people who can.” 

It’s a pretty wide range of 

interests and skills for sure. But 
it only takes a brief look at Lucy’s 
résumé to realise that she means 
it. When she says she’s interested 
in everything around her, this 


interest reaches from electronics to 
engineering, wearable tech, space, 
robotics, and robotic dinosaurs. 
And she can be seen talking about 
all of these things across various 
companies’ social media, such 

as IBM, websites including the 
Women’s Engineering Society and 
books, including her own. 

When not attending conferences 
as guest speaker, tinkering with 
electronics or creating engaging 
IoT tutorials, she can be found 
retrofitting Raspberry Pis into 
the aforementioned robotic 
dinosaurs at Blackgang Chine 
Land of Imagination, writing, and 
judging battling bots for the BBC’s 
Robot Wars. 


With her bright LED boots, Lucy was one of the wonderful Pi community 


members invited to join us and HRH The Duke of York at St James's Palace last year 
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Among many other projects, Dr Lucy Rogers currently focuses 
much of her attention on reducing the damage from space debris 


Lucy graduated from Lancaster 
University with a degree in 
Mechanical Engineering. From 
there, she spent seven years at 
Rolls-Royce Industrial Power 
Group as a graduate trainee before 
becoming a chartered engineer and 
earning her PhD in bubbles. 


Bubbles? 


“Foam formation in low-expansion 
fire-fighting equipment. I 
investigated the equipment 
to determine how the bubbles 
were formed,” she explains. 
Obviously. Bubbles! 

She then went on to become a 
fellow of the Royal Astronomical 
Society (RAS) in 2005 and, later, 


DR LUCY ROGERS 


Community 
HIGHLIGHTS 


magpi.cc/2pEHdwG 


In 2014, with the help of Neil 
Ford and Andy Stanford-Clark, 
Lucy worked with the UK’s oldest 
amusement park, Blackgang Chine 
Land of Imagination, on the Isle of 
Wight, with the aim of updating its 
animatronic dinosaurs. The original 
Blackgang Chine dinosaurs hada 
limited range of behaviour: able to 
roar, move their heads, and stomp a 
foot in a somewhat repetitive action. 
When she contacted Raspberry Pi 
back in the November of that same 
year, the team were working on 
more creative, varied behaviours, 
giving each dinosaur a new 
Raspberry Pi-sized brain. This later 
evolved into a very successful dino- 
hacking Raspberry Jam. 


Lucy was asked to help judge 
the first round of the ‘Make 
us laugh’ Pioneers challenge 


a fellow of both the Institution of 
Mechanical Engineers (IMechE) and 
British Interplanetary Society. 

As amember of the Association 
of British Science Writers, Lucy 
wrote It’s ONLY Rocket Science: an 
Introduction in Plain English and 
will be publishing Wiring the IoT 
alongside Dr Andy Stanford-Clark 
later this year. 

As a standout member of the 
industry, and all-round fun person 
to be around, Lucy has quickly 
established herself as a valued 
member of the Pi community. 
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Given her love for tinkering 
with tech, and a love for stand-up 
comedy that can be uncovered via 
a quick YouTube search, it’s no 
wonder that Lucy was asked to help 
judge the first round of the ‘Make 
us laugh’ Pioneers challenge for 
Raspberry Pi. Alongside comedian 
Bec Hill, Code Club UK director Maria 
Quevedo, and the face of the first 
challenge, Owen Daughtery, Lucy 
leant her expertise to help name 
winners in the various categories 
of the teens event, and offered her 
support to future Pioneers. 
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Sue's Code 
Club members 
getting to grips 
with Scratch 
and Python 
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INTERVIEW 


hat inspired you to 

volunteer for Code Club? 

“Pd heard of Code Club 
and when I investigated a bit, I found 
that it was pretty easy to register. 
Pm really keen to get youngsters 
started with tech at a young age and 
get them inspired early. I think it’s 
important to show them that they 
can ‘own’ the technology and make 
it do what they want.” 


Tell us as a bit about your 

Code Club 

“I manage two Code Clubs locally. 
The first is in a small primary 
school and the numbers have varied 
over the three years that I’ve been 
running it. At the moment I’ve got 
just two girls who’ve been with me 


from the start and we have a super 
time. We’ve done a lot of the Scratch 
projects, some HTML and Python, as 
well as a little wearable project. 

“The second club started this year, 
at another local primary school, and 
Pve been invited to teach a whole 
class as part of their computing 
curriculum. A set of Raspberry Pi 
and Google Chromebooks means 
they are fairly well versed in 
computing already.” 


What would you say are the 
benefits of volunteering for 
Code Club? 

“Code Club has allowed me to 
find out about what is taught in 
primary school and get an idea of 
the areas that teachers struggle 
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CODE CLUB OF THE MONTH 


Community 


Sue's second Code Club is 
run as part of the timetable 
for the whole class 


primary schools (certainly the ones 
Pve visited either for Code Club 

or CAS Barefoot) needs a boost, 
especially given the technological 
world these young people are 
growing up in and the influence 
tech will have on them.” 


What has been your best 
‘Code Club moment’? 
“Emma, who has been with my 
Code Club for three years and loves 
it, once said: ‘I love Code Club, just 
us girls coding and chilling.’ 
“Having the Raspberry Pi 
Foundation visit my newest Code 
Club to film the children for the 
promo video for Hello World 
magazine was also great. They 
were brilliant and totally thrilled 
to be movie stars. When I showed 
them the final video, they loved it 
so much we watched it twice.” 


with or find easy. It also led me to 
volunteer for CAS Barefoot so that 
I could do something to help the 
teachers. Volunteering gives me 
an insight into primary teaching 
and allows me to do fun stuff and 
pretty much organise what I want 


Why is Code Club important 

to you? 

“Code Club provides the 

projects and ideas, which makes 
volunteering easy. I don’t have to 
devise ideas and projects but can 
take the Code Club materials and 


Is there anything unique about 
your Code Club you’d like 

to share? 

“Maybe my second Code Club is 
unique as the school has invited 
me to teach a whole class. The 
‘normal’ model would be an 
after-school club, I guess. As Pm 
doing Code Clubs in local primary 
schools, I get to promote our high 
school and it’s lovely to see some 
of my first Clubbers now in our 
Year 7 classes.” 


Code Club provides the 
projects and ideas, which 
makes volunteering easy 


to do. It also allows me to take a 
project idea and, with input from 
the children, take the project in 
a different direction.” 


just go with those or, taking ideas 
from the children, we can use these 
as a launch pad for our own ideas. 
It’s also clear that computing in 


EVENT HIGHLIGHTS 


Here’s what went on at Jams and other Raspberry Pi events around the world this month 


2 Follow 


P Sarah Roman 


Great turnout at the Raspberry Jam at the 
@FTPLibrary! Probably the best jam I've held 
yet - Happy Saturday! #rjam #raspberrypi 


franklintwp.org 


FRANKLIN TOWNSHIP 
PUBLIC LIBRARY 

This Raspberry Jam in New 
Jersey, USA, apparently 
gets bigger all the time, 
according to organiser 
Sarah Roman 
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= RestLondonsam Prem 


#cgpijam #cgjam #raspberryjam @dragonhall 
Jam in full swing! 


LE 
magpi.cc/2q8PGKT 
COVENT GARDEN 
RASPBERRY JAM 

The spring Jam was a huge 
success, with loads of 

Jam veterans helping out, 


including the folk who run 
the East London Jam 


= NI Raspberry Jam 


Hugely successful April NI @Raspberry_Pi 
Jam today at @qubmathsphys. By far our 
largest to date! 


$ Follow 


NORTHERN IRELAND 
RASPBERRY JAM 
Andrew Mulholland's 
Northern Ireland Jam 
happens every month, and 
is one of the premier Jams 
in NI 


> Ben Nuttall 
oes 
Raspberry Jam @ Pi Towers in full swing 
#rjam #picommunity 


Following 


a 


magpi.cc/ 2q95m0t 


PI TOWERS 
RASPBERRY JAM 

Ben Nuttall from the 
Raspberry Pi Foundation 
puts on a regular Jam at 
Raspberry Pi HQ itself, and 
it's always a blast 
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haat — MELBOURNE PI ~ 
USER GROUP 
4 ` 
DIGITALES HANDWERK UND NEWHAVEN RASPBERRY RASPBERRY JAM LEEDS 
NEUE TECHNOLOGIEN I/II JAM When: Wednesday 7 June 
When: Saturday 10 June When: Saturday 24 June Where: Swallow Hill Community 
Where: Liebenfelser Immobilien Where: Hillcrest Community College, Leeds, UK 
AG, Herdern, Switzerland Centre, Newhaven, UK magpi.cc/2q9ShEp 
magpi.cc/2r8tpdk magpi.cc/2r8H10Y There will be chances to get 
The mini-workshop is aimed at Come along to the second hands-on with digital making 
12 to 16-year-olds. Topics include Newhaven Raspberry Jam and find activities through workshops 
3D printing, pi-top, and RetroPie. out more about the Raspberry Pi. and a hackspace area. 
MELBOURNE PI USER GROUP ROCKVILLE RASPBERRY CORNWALL TECH JAM 
When: Tuesday 20 June JAM When: Saturday 10 June 
Where: Rudolf Steiner School, When: Saturday 15 July Where: Bodmin Library, Bodmin, UK 
Warranwood, VIC, Australia Where: Red Brick Courthouse, cornwalltechjam.uk 
magpi.cc/2mx2y7Y Rockville, MD, USA For anyone interested in 


technology, of all ages and abilities. 
Ask questions and learn about 
programming: Scratch, Python, 
Minecraft, and much more. 


The group’s aim is to bring 
like-minded people together 
to talk about how they’re using 
Raspberry Pis. 


magpi.cc/2r8fVhF 

An afternoon of Raspberry 
Pi presentations, exhibits, 
and more. 
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Community 


JAMS 
EVERYWHERE! 


HEAT MAP 


CAN YOU HELP INCREASE 


THE AMOUNT OF JAMS 
IN THE AREAS THAT NEED MORE? 


; a 
HOLL 
RASPBERRY JAM 
AP; 
Sa RASPBERRY JAM 
“OF LEEDS 
8 
8 COTSWOLD 
| 4 RASPBERRY JAM 
ih = 
4 a A 


NEWHAVEN 
5 RASPBERRY JAM 


HULL RASPBERRY JAM 
When: Saturday 17 June 
Where: Hull Central Library, 

Hull, UK 
magpi.cc/2q9EvS9 
Join the team at Hull Raspberry 
Jam to share, learn, and tinker 

7 with digital making projects 
using Raspberry Pi. 


COTSWOLD RASPBERRY 

JAM 

When: Saturday 24 June 

Where: Waterworth Building, Park 
Campus, Cheltenham, UK 

cotswoldjam.org 

An event which showcases 

and helps people learn about 

the Raspberry Pi computer. 
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JAM ADVICE 


Putting on a Raspberry Jam may seem 
daunting, but anyone can do it. The 
Raspberry Pi Foundation has released a 
free guidebook full of advice on putting 
on your own Jam. Here's why Dr Lucy 
Rogers runs her Jams: 

"| love to learn. By bringing makers 
and others together, | get to see a 
variety of things and discuss amazing 
ideas. It's great to see eight-year-olds 
and 80-year-olds making lights blink 
and dinosaurs nod.” 


Get the book here: magpi.cc/2q9DHfQ 


a JAM < 
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LETTERS 


French ESA Astronaut Thomas Pesquet looked 
after the Astro Pi experiments this time around 


Scratch the itch 

I’m a big fan of using Scratch to code as it’s quite easy and fun. 

I do like it when you have Scratch tutorials in the mag and I loved 
the Scratch Essentials book. However, you do focus quite a bit on 
Python code and such. Is there any chance of getting more Scratch 
tutorials in the mag? Also, is there any word on Scratch 2.0 coming 
to the Raspberry Pi? 

Susan 


Hopefully you’ve enjoyed the Scratch tutorials in this issue, as well as 
the EduBlocks tutorial in the Minecraft feature. As Scratch is a little 
more limited than Python, we don’t tend to cover it as much, but we 
do use it when we feel it makes sense. 

As for Scratch 2.0, you can currently use it via the browser, but look 
out for future versions of Raspbian. There is some special work being 
done behind the scenes... 
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AlY thanks 

Just wanted to say how much the latest issue #57 
has really amazed me. I have joked on Twitter 
about Skynet/Jeff Goldblum/Dr Who [Ed’s note: 
To be fair, so did we] and taking over the world 
etc., but I really am so pleased that you have this 
wonderful project with your excellent magazine. 

My son (14 and a half) is currently homeschooled 
(he has not managed a single full year of school as 
he has ASD). He worked on this project from 10am to 
2pm all by himself (I helped with sticky tape). 

Normally I buy The MagPi for him to drool over 
the projects inside, as they are out of our ability to 
make, but I hope to give him aspiration for what to 
do with the many Raspberry Pis he has got over the 
years. This time, however, a real-life project was all 
there for him, with instructions. 

He's had a very hard journey butting up against the 
education system, and the Raspberry Pi and coding 
have made a huge difference in encouraging him to 
learn and try out new things, and believe in himself 
and his own skills. 

We are hoping to go to a nearby Raspberry Jam 
soon (we found this through your magazine), and 
he's really looking forward to it. 

Thanks from a grateful parent, 

Kay Marshall 


You re most welcome. It's letters like these from 
parents, and teachers, telling us how young people 
are having fun with the stuff we do in the magazine 
that makes it all worthwhile. 

We’ll have more amazing issues like this in the 
future, but in the meantime we hope you will enjoy 
some of the other cool projects in the magazine. 


< db 


Our AIY 

Projects voice 
kit giveaway was 
one of biggest 
yet and it went 


down very well 


raspberrypi.org/magpi 


= Way around it, that’s like “hey you can install 
„ this software, just stick this keygened code in and 


ignore T&Cs. Carry on as normal after it.” 


bensimmo 
The Raspberry Pi Forum is a hotbed of We were very aware of this issue when we planned the 
conversations and problem-solving for the giveaway originally, and worked closely with Google to 
community. Join in via raspberrypi.org/forums make sure it was all correct. There is no problem with 
the way we are asking our readers to use their services, 
any of us are having the problem of having to use so you don’t need to worry. 
a business account to use the AIY Voice Projects Kit. Hopefully the influx of British users to the service 
You recently tweeted this: “PSA: You can absolutely use will persuade Google to change the way this is 
the i+ATYProjects kit in the UK/EU even if you're not a business! worded in the long run. 


Just put your name in the company name field.” 

My question is do you have Google’s permission to advocate 
breaking their T&Cs (it is assumed so by people since you are 
partners with them for this). 

In my eyes doing this is a morally wrong thing, in effect a 
fake business account. While it may not be harmful and is a 


WD PIDRIVE FOUNDATION EDITION 


With our custom NOOBS software, you can install 
an OS directly on a WD PiDrive with up to 375GB of 
capacity to easily access and store multiple projects. 


Includes microSD™ card 
with starter software Includes microSD™ card with starter 
$18.99 Ly software and WD PiDrive Cable 


Starting at $28.99 


Now available at wdlabs.io/mp58c © wDLABS 


Western Digital, WDLabs, and the WDLabs logo are registered tradema! t g and/or other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation. 
microSD is a trademark of SD-3C, LLC. All other marks are the property s s. As use c gigab' ne billion bytes. Total accessible capacity varies depending on operating environment 
Product price and specifications subject to change without notice. Pictures oration or its affiliates. 


MATT RICHARDSON 


Column THE FINAL WORD 


Matt Richardson is the Executive Director of Raspberry Pi 
Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


S TAKING THE 
-FIRST STEP 


Matt Richardson on how booting up a Raspberry Pi is just the beginning 


ive years ago this month was the first time 
I unboxed a Raspberry Pi. I hooked it up to 
our living room television and made space 
on the TV stand for an old USB keyboard and mouse. 
Watching the $35 computer boot up for the first 
time impressed me, and I had a feeling it was a big 
deal, but Pll admit that I had no idea how much of a 
phenomenon Raspberry Pi would become. I had no 
idea how large the community would grow. I had no 
idea how much my life would be changed from that 
moment on. And it all started with a simple first 
step: booting it up. 

The key to the success of Raspberry Pi as a 
computer — and, in turn, acommunity anda 
charitable foundation — is that there's a low barrier 
to the first step you take with it. The low price is 
a big reason for that. It’s not a difficult decision, 
whether or not to try Raspberry Pi. Since it’s 
so affordable, you can give it a try and see how 
things go. 

Linus Torvalds, the creator of the Linux operating 
system kernel, talked about this in a BBC News 
interview in 2012. He explained that a lot of people 
might take the first step with Raspberry Pi, but not 
everyone will carry on with it. But getting more 
people to at least take that first step of turning it on 
means more people who can be potentially impacted 
by the technology. 

“I find things like Raspberry Pi to be an important 
thing: trying to make it possible for a wider group 
of people to tinker with computers,” said Torvalds. 
“And making the computers cheap enough that you 
really can not only afford the hardware at a big scale, 
but perhaps more important, also afford failure.” 
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In other words, if things don’t work out with you and 
your Raspberry Pi, then it’s not such a big deal because 
it’s such an affordable computer. 

Of course, we hope that more and more people who 
boot up a Raspberry Pi for the first time will decide 
to continue experimenting, creating, and learning 
with it. Thanks to improvements in the hardware, 
the Raspbian operating system, and free software 
packages, it’s becoming easier than ever to do so many 
amazing things with this little computer. And our 
continually growing community means you’re not on 
this journey on your own. These improvements and 
growth over the past few years hopefully mean that 
more people who boot up Raspberry Pis are encouraged 
to keep exploring. 


The first step 
However, the important thing is that people are given 
the opportunity to take that first step, especially young 
people. For young learners, this is a critical age when 
something like Raspberry Pi can have an enormously 
positive impact on the rest of the lives. It’s a major 
reason why our free resources are aimed at young 
learners. It’s why we train educators all over the world 
for free. Encouraging youth to take their first step with 
Raspberry Pi could not only make a positive difference 
in the lives of the individuals, but also society at large. 
With the affordable computational power, excellent 
software, supportive community, and free resources, 
you’re given everything you need to make a big 
difference in the world when you boot up a Raspberry 
Pi for the first time. That moment could be step one of 
ten, or one of ten thousand, but it’s up to you to take 
that first step. 
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Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 
Make simple electronic circuits 


nasties Pi board and case 
Ower supply and HDMI cable 
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Available in Europe 
through RS Components 


$89” £69” 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanaKit is a registered 
trademark of Cana Kit Corporation. 
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